创建 Claude 消息 - InfinityBlue API

curl --request POST \
  --url https://api.getinfinityblue.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --data '
{
  "model": "claude-3-opus-20240229",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍你自己。"
    }
  ]
}
'

{
  "id": "<string>",
  "type": "<string>",
  "role": "<string>",
  "content": [
    {
      "type": "<string>",
      "text": "<string>"
    }
  ],
  "model": "<string>",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123
  }
}

POST

messages

curl --request POST \
  --url https://api.getinfinityblue.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --data '
{
  "model": "claude-3-opus-20240229",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍你自己。"
    }
  ]
}
'

{
  "id": "<string>",
  "type": "<string>",
  "role": "<string>",
  "content": [
    {
      "type": "<string>",
      "text": "<string>"
    }
  ],
  "model": "<string>",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123
  }
}

可填写的模型

模型 ID	说明
`claude-3-opus-20240229`	Claude 3 旗舰，顶级推理与理解能力
`claude-3-5-sonnet-20241022`	Claude 3.5 Sonnet，均衡性能
`claude-3-5-haiku-20241022`	Claude 3.5 Haiku，快速轻量

完整列表见 GET /v1/models。

版本头

每次请求必须携带 anthropic-version: 2023-06-01（或更新版本）。

系统提示

system 字段可以是纯文本字符串，也可以是包含缓存控制块的对象数组，用于精细控制提示缓存行为。

工具调用

在 tools 中定义函数，使用 JSON Schema 描述 input_schema。模型会在 content 中返回 tool_use 类型的块；将工具执行结果以 tool_result 类型回填到下一轮请求中。

扩展思考（Extended Thinking）

设置 thinking.type: enabled 并指定 thinking.budget_tokens 可启用扩展思考模式，模型会在响应中返回 thinking 类型的内容块。

流式输出

设置 stream: true 后，响应以 Server-Sent Events 形式返回，事件类型包括 message_start、content_block_delta、message_stop 等。

授权

Authorization

string

header

必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。在控制台获取 API Key。

请求头

anthropic-version

string

必填

Anthropic API 版本号，当前推荐值为 2023-06-01。

示例:

"2023-06-01"

x-api-key

string

Anthropic API Key（可选）。也可使用标准的 Authorization: Bearer YOUR_KEY 头，二者任选其一。

请求体

application/json

Anthropic Claude Messages API 请求体。

model

string

必填

模型 ID，例如 claude-3-opus-20240229。完整列表见 GET /v1/models。

示例:

"claude-3-opus-20240229"

messages

object[]

必填

对话消息列表，role 必须在 user 和 assistant 之间交替。

Show child attributes

max_tokens

integer

必填

模型在本次响应中可生成的最大 token 数，必须指定。

必填范围: x >= 1

system

系统提示，可以是纯文本字符串，也可以是包含缓存控制块的对象数组。

temperature

number

采样温度，取值 0–1，控制输出随机性。

必填范围: 0 <= x <= 1

top_p

number

核采样概率阈值，与 temperature 二选一调整。

top_k

integer

Top-K 采样参数，仅考虑概率最高的 K 个 token。

stream

boolean

是否以 Server-Sent Events 流式返回。

stop_sequences

string[]

停止序列列表，模型生成到其中任一序列时停止。

tools

object[]

模型可调用的工具列表，每个工具需提供 name、description 和 input_schema。

Show child attributes

tool_choice

object

工具调用策略。auto 由模型自行决定，any 强制至少调用一个工具， tool 强制调用指定工具（需同时提供 name）。

Show child attributes

thinking

object

扩展思考（Extended Thinking）配置，仅对支持该功能的模型生效。

Show child attributes

metadata

object

请求附加元数据。

Show child attributes

响应

成功创建消息

Anthropic Claude Messages API 响应体。

string

本次消息的唯一标识。

type

string

对象类型，值为 message。

示例:

"message"

role

string

响应角色，值为 assistant。

示例:

"assistant"

content

object[]

响应内容块列表，可包含文本、工具调用或思考块。

Show child attributes

model

string

实际处理请求的模型。

stop_reason

enum<string>

生成结束原因。

可用选项:

end_turn,

max_tokens,

stop_sequence,

tool_use

usage

object

Token 用量统计。

Show child attributes

Gemini 原生格式文生图

⌘I

​可填写的模型

​版本头

​系统提示

​工具调用

​扩展思考（Extended Thinking）

​流式输出

授权

请求头

请求体

响应

可填写的模型

版本头

系统提示

工具调用

扩展思考（Extended Thinking）

流式输出