文本模型进阶用户更新于
POST/v1/messages

API 调试台

POST/v1/messages
查看密钥

使用你填写的 Key 发送真实请求,按对应接口计费。

Claude Opus 5.5

请求 ID claude-opus-5-5

协议

认证

请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时,设置 Content-Type: application/json。

  • Anthropic Messages · x-api-key: YOUR_API_KEY

请求参数

POST /v1/messages

参数类型是否必填说明
modelstring必填填写模型 ID claude-opus-5-5。
messagesobject[]必填按会话顺序发送 user 和 assistant 消息。系统指令放在顶层 system。
messages[].contentstring / object[]必填消息正文。可用纯文本或协议定义的内容块数组。
messages[].content[]object视条件图片输入使用 type: image 的内容块,图片数据放在 source。可用格式取决于所选接入点。
systemstring / object[]选填系统指令。可用文本或文本块数组。
max_tokensinteger必填输出 token 的上限。可用上限因模型和接入点而异。
streamboolean选填true 请求 SSE 流式响应,false 请求普通 JSON。以所选接入点支持的模式为准。
temperaturenumber视条件控制采样随机性。可用取值以及该字段是否生效,取决于模型和接入点。
top_pnumber视条件按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
thinking.typestring选填使用 adaptive。旧式 enabled 和 budget_tokens 不属于此型号的原生格式。
output_config.effortstring视条件请求的推理强度。有效档位和是否能关闭推理取决于模型及所选接入点。
toolsobject[]视条件供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
tool_choiceobject视条件一般工具调用使用 type: auto。此型号不支持通过 any 或 tool 强制调用普通工具。

POST /v1/messages/count_tokens

参数类型是否必填说明
modelstring必填填写模型 ID claude-opus-5-5。
messagesobject[]必填按会话顺序发送 user 和 assistant 消息。系统指令放在顶层 system。
messages[].contentstring / object[]必填消息正文。可用纯文本或协议定义的内容块数组。
messages[].content[]object视条件图片输入使用 type: image 的内容块,图片数据放在 source。可用格式取决于所选接入点。
systemstring / object[]选填系统指令。可用文本或文本块数组。
toolsobject[]视条件需要计入输入 token 的工具定义。传入与实际 Messages 请求相同的工具。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY,并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时,按对应客户端指南配置。

Anthropic Messages

bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "claude-opus-5-5",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "claude-opus-5-5",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

读取响应

  • Anthropic Messages · 从 content[] 中读取类型为 text 的块。流式响应按顺序处理 SSE 内容块事件。 JSON · SSE
  • Count Tokens · 从 input_tokens 读取输入 token 数。

完整接入指南

能力与限制

  • streaming · 支持
  • tool_calling · 支持
  • image_input · 有条件支持 — 取决于兼容的接入点与请求格式
  • video_input · 不支持

兼容别名与退役重定向

  • claude-opus-4-5, claude-opus-4-5-20251101, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8 → claude-opus-5-5 (退役重定向)
  • opus4.8 → claude-opus-5-5 (别名)

模型能力目录 · 查看定价