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>
必填

模型 ID。

可用选项:
claude-opus-5
示例:

"claude-opus-5"

messages
object[]
必填

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

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

生成前允许的最大 token 数。Claude Opus 5 最多支持 128K 输出 Token。

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

4096

system

系统提示词,用于提供上下文和指令。

metadata
object

请求的元数据对象。

stop_sequences
string[]

会导致模型停止生成的自定义文本序列。

stream
boolean
默认值:false

是否使用服务器发送事件增量流式返回响应。

tools
object[]

模型可使用的工具定义。

tool_choice
object

模型如何使用工具。

output_config
object

支持自适应思维 effort 的模型输出控制配置。

thinking
object

默认启用自适应思维,不支持手动扩展思维。仅在 low、medium 或 high effort 下可以关闭思维;xhigh 或 max 会返回 400 错误。

响应

消息创建成功

id
string
必填
示例:

"msg_01XFDUDYJgAACzvnptvVoYEL"

type
string
必填
示例:

"message"

role
string
必填
示例:

"assistant"

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

"claude-opus-5"

stop_reason
enum<string>
必填

被模型拒绝的请求会返回 refusal

可用选项:
end_turn,
max_tokens,
stop_sequence,
tool_use,
refusal,
null
usage
object
必填
stop_sequence
string | null
stop_details
object | null

服务平台返回的附加停止信息。