Claude Sonnet 4.6
Anthropic Claude Sonnet 4.6 兼顾速度与智能的平衡型模型。原生 /v1/messages 协议,支持流式输出、工具调用和可选的扩展思考。
模型
| 模型名称 | 上下文窗口 | 推理 |
|---|---|---|
claude-sonnet-4-6 | 200K tokens | 是(可选 thinkingFlag) |
定价
按 token 计费:
| 类型 | 积分 / 百万 tokens | 价格 / 百万 tokens |
|---|---|---|
| 输入 (Input) | 300 credits | $1.50 |
| 输出 (Output) | 1500 credits | $7.50 |
接口地址
POST https://api.aivideoapi.ai/v1/messages
兼容 Anthropic Messages API 协议。可直接使用 @anthropic-ai/sdk,将 baseURL 指向 https://api.aivideoapi.ai/v1。
创建对话
curl -X POST https://api.aivideoapi.ai/v1/messages \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{ "role": "user", "content": "写一首关于秋天的俳句" }
],
"stream": false
}'
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 必须为 claude-sonnet-4-6 |
messages | array | 是 | 对话消息列表 |
stream | boolean | 否 | 是否流式输出(默认 true) |
tools | array | 否 | 可调用工具 |
thinkingFlag | boolean | 否 | 是否开启扩展思考 |
响应(非流式)
{
"role": "assistant",
"type": "message",
"id": "msg_01ABC...",
"model": "claude-sonnet-4-6",
"stop_reason": "end_turn",
"content": [
{ "type": "text", "text": "落叶舞秋风\n清晨霜染金黄叶\n岁月静无声" }
],
"usage": { "input_tokens": 18, "output_tokens": 42 },
"credits_consumed": 0.06
}
字段说明同 Claude Opus 4.6 文档。credits_consumed 为本平台实际扣费积分,按本模型单价(input 300 / output 1500 credits per 1M tokens)计算。
响应(流式)
参见 Claude Opus 4.6 文档 的流式响应格式(事件名称完全一致)。
示例
多轮对话
curl -X POST https://api.aivideoapi.ai/v1/messages \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{ "role": "user", "content": "推荐一本科幻小说" },
{ "role": "assistant", "content": "我推荐《三体》。" },
{ "role": "user", "content": "为什么推荐它?" }
]
}'
函数调用
curl -X POST https://api.aivideoapi.ai/v1/messages \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{ "role": "user", "content": "查询订单 12345 的状态" }
],
"tools": [
{
"name": "get_order_status",
"description": "根据订单号查询当前状态",
"input_schema": {
"type": "object",
"properties": {
"order_id": { "type": "string" }
},
"required": ["order_id"]
}
}
]
}'
常见错误码
请求失败时,API 返回 JSON 格式的错误响应:
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}
错误码一览
| HTTP 状态码 | 错误码 | 类型 | 说明 |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | 缺少必填参数或参数无效 |
| 401 | invalid_api_key | authentication_error | API Key 无效、已禁用或已删除 |
| 402 | insufficient_credits | billing_error | 积分余额不足,请充值 |
| 403 | ip_not_allowed | permission_error | 请求 IP 不在 Key 的白名单中 |
| 404 | model_not_found | invalid_request_error | 模型不存在或已停用 |
| 404 | task_not_found | invalid_request_error | 任务 ID 不存在 |
| 429 | rate_limit_exceeded | rate_limit_error | 请求过于频繁,请降低频率 |
| 429 | spend_limit_exceeded | billing_error | 达到 Key 的消费限额(每小时/每天/总量) |
| 500 | internal_error | api_error | 服务器内部错误 |
| 503 | upstream_error | upstream_error | 上游 AI 服务返回错误 |
常见场景
invalid_request (400)
缺少必填字段或参数格式错误时返回。
{
"error": {
"code": "invalid_request",
"message": "'model' is required.",
"type": "invalid_request_error"
}
}
insufficient_credits (402)
积分不足。可通过 GET /v1/credits 查询余额,前往 Dashboard > Billing 充值。
invalid_api_key (401)
可能原因:
- Key 不以
sk-开头 - Key 已被禁用或删除
- 用户账户已被封禁
upstream_error (503)
上游 AI 服务返回错误,可能原因:
- 输入内容包含敏感或违规信息
- 上游服务暂时不可用
- 请求参数不被上游支持
因上游错误导致任务失败时,预扣积分会自动退还。