消息与流式调用¶

接口用途¶

提供 Anthropic 原生 Messages 形态。已有 Anthropic SDK 或依赖 content[]、原生流式事件的应用可使用该入口。

请求方式¶

POST

接口地址¶

$GENESIS_BASE_URL/messages

身份认证¶

使用 Genesis API Key：Authorization: Bearer <API_KEY>。详见接口地址与身份认证。

接入约定¶

原始 HTTP 调用仍使用 Genesis Bearer Key：

Authorization: Bearer <API_KEY>

请求与响应采用 Anthropic Messages 的字段结构，业务结果位于 content[]。流式调用返回该生态的原生事件，而不是 Chat Completions 的 choices[].delta。

Genesis「使用」页提供 Messages 代码示例。使用官方 Anthropic SDK 时，将 SDK 的 baseURL 指向页面显示的 Genesis 源地址；SDK 会附加 /v1/messages。这里的源地址是否已经包含版本段取决于生成示例，不能直接照搬 OpenAI SDK 的 GENESIS_BASE_URL 拼接规则。认证头和 SDK 参数也应以控制台生成的当前示例为准。

组织对话¶

Messages 请求至少需要目标模型、消息列表和模型要求的输出限制。消息按时间顺序排列，每条消息的内容可以由一个或多个内容块组成。系统指令、图像内容块和其他扩展能力是否可用，取决于目标模型。

不要在 /messages 与 /chat/completions 之间直接复用序列化后的请求体：

Messages	Chat Completions
Anthropic 原生请求与 `content[]` 响应	OpenAI 兼容请求与 `choices[]` 响应
Anthropic 原生 SSE 事件	`data:` 增量与 `[DONE]`
SDK 使用 Genesis 源地址配置	SDK 使用 Genesis Base URL 配置

如果应用需要在两种接口间切换，先在内部定义统一消息模型，再为每个端点实现独立适配层。

流式调用¶

启用流式输出时，按事件类型累计内容块，并在原生终止事件到达后完成消息。解析器要允许一个内容块被拆成多个网络分片，也要保留最终事件中的停止原因和用量。连接中断后的重试可能形成第二次请求，不应把两次流简单拼接。

流式处理的通用注意事项见返回结果、分页与流式响应。模型是否支持 Messages 及其具体字段，应先在模型详情和调试页确认。