POST
这是 Claude(Anthropic)最核心的对话协议,支持文本、多模态、工具调用与 SSE 流式输出。
系统在该路径下对齐 Anthropic 的字段与事件流格式,便于直接复用现有 Claude SDK 或请求结构。
https://api.poixe.com/v1/messages鉴权与请求头
所有请求都需要携带 API Key,同时建议固定携带anthropic-version 以保证行为稳定。
Poixe API Key。格式为
X-Api-Key: YOUR_API_KEY(等价于 x-api-key)。Anthropic 版本号,例如:
2023-06-01。必须设置为
application/json。核心请求参数
以下为最常用、最通用的一组字段(足够覆盖:普通对话 + 工具调用 + 流式)。模型 ID,例如:
claude-sonnet-4-5-20250929。对话消息列表。
本次生成允许的最大输出 Token 数。
是否开启 SSE 流式输出。为
true 时返回 text/event-stream。可选:采样温度。越低越稳定,越高越发散(不传则使用模型默认值)。
可选:系统提示词(用于设定助手整体行为)。
可选:工具列表(函数/工具调用)。
可选:工具调用策略,例如
{"type":"any"}(允许调用任意工具)。响应结构与流式事件
非流式时,返回一个message 对象;流式时,返回一系列 SSE 事件(message_start → content block events → message_delta → message_stop),其中可能穿插 ping。
消息 ID,例如
msg_xxx固定为
message固定为
assistant生成内容数组,常见为
[{ "type": "text", "text": "..." }]。停止原因,常见:
end_turn / max_tokens / stop_sequence / tool_use(以及少数情况:pause_turn / refusal / model_context_window_exceeded 等)。命中 stop 序列时返回对应字符串,否则为
null。Token 用量统计。