Skip to main content
POST
创建消息

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
enum<string>
必填

用于补全的模型。

可用选项:
claude-sonnet-4-6,
claude-sonnet-4-5-20250929,
claude-sonnet-4-20250514,
claude-opus-4-6,
claude-opus-4-5-20251101,
claude-opus-4-1-20250805,
claude-opus-4-20250514,
claude-haiku-4-5-20251001,
claude-3-7-sonnet-20250219,
claude-3-5-sonnet-20241022
示例:

"claude-sonnet-4-6"

messages
object[]
必填

输入消息列表。每条消息包含角色和内容。

Minimum array length: 1
示例:
max_tokens
integer
必填

停止生成前的最大 token 数。

必填范围: x >= 1
示例:

1024

system

系统提示。为 Claude 提供上下文和指令。

metadata
object

描述请求元数据的对象。

stop_sequences
string[]

自定义文本序列,遇到时模型将停止生成。

temperature
number
默认值:1

注入响应的随机性。范围 0.0 到 1.0。

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

1

top_p
number

使用核采样。建议使用 temperature 或 top_p 之一,不要同时使用。

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

仅从每个后续 token 的前 K 个选项中采样。

必填范围: x >= 0
stream
boolean
默认值:false

是否使用服务器发送事件 (SSE) 增量流式传输响应。

tools
object[]

模型可使用的工具定义。

tool_choice
object

控制模型如何使用提供的工具。

thinking
object

扩展思考配置。启用后,模型会在回复前进行深度思考。

响应

消息创建成功

id
string
必填
示例:

"msg_01XFDUDYJgAACzvnptvVoYEL"

type
string
必填
示例:

"message"

role
string
必填
示例:

"assistant"

content
object[]
必填
示例:
model
string
必填
示例:

"claude-sonnet-4-6"

stop_reason
enum<string>
必填
可用选项:
end_turn,
max_tokens,
stop_sequence,
tool_use,
null
usage
object
必填
stop_sequence
string | null