Claude Sonnet 4.6

Anthropic Claude Sonnet 4.6 兼顾速度与智能的平衡型模型。原生 /v1/messages 协议,支持流式输出、工具调用和可选的扩展思考。

模型

模型名称上下文窗口推理
claude-sonnet-4-6200K 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
  }'

请求体

字段类型必填说明
modelstring必须为 claude-sonnet-4-6
messagesarray对话消息列表
streamboolean是否流式输出(默认 true
toolsarray可调用工具
thinkingFlagboolean是否开启扩展思考

响应(非流式)

{
  "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 状态码错误码类型说明
400invalid_requestinvalid_request_error缺少必填参数或参数无效
401invalid_api_keyauthentication_errorAPI Key 无效、已禁用或已删除
402insufficient_creditsbilling_error积分余额不足,请充值
403ip_not_allowedpermission_error请求 IP 不在 Key 的白名单中
404model_not_foundinvalid_request_error模型不存在或已停用
404task_not_foundinvalid_request_error任务 ID 不存在
429rate_limit_exceededrate_limit_error请求过于频繁,请降低频率
429spend_limit_exceededbilling_error达到 Key 的消费限额(每小时/每天/总量)
500internal_errorapi_error服务器内部错误
503upstream_errorupstream_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 服务返回错误,可能原因:

  • 输入内容包含敏感或违规信息
  • 上游服务暂时不可用
  • 请求参数不被上游支持

因上游错误导致任务失败时,预扣积分会自动退还。