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

API 调试台

POST/v1/messages
查看密钥

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

Claude Opus 5

请求 ID claude-opus-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。
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视条件按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
toolsobject[]视条件供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
tool_choiceobject视条件控制工具选择。强制或指定工具只在所选接入点明确支持时使用。

POST /v1/messages/count_tokens

参数类型是否必填说明
modelstring必填填写模型 ID claude-opus-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",
  "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",
  "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 · 不支持

兼容别名与退役重定向

  • opus5 → claude-opus-5 (别名)

模型能力目录 · 查看定价