用 Messages 生成
POST /v1/messages
Anthropic Messages 兼容的生成接口。传 model、messages 和 max_tokens。本接口除 Bearer 外也接受 x-api-key,并在 anthropic-version、anthropic-beta 存在时转发。文本读 content[] 里的文本块;这个结构和 Responses、Chat Completions 都不同,错误也用 Anthropic 的错误信封。流式用 content_block_delta 和 message_stop。每个接口都要求模型的 supported_endpoints 精确包含该路径。这几个接口转发所选模型自己的协议,可选参数和响应细节会随本地 worker 或远程供应方不同。本地模型把输入留在设备上;配置为远程的模型会收到发给它的请求。
参数
anthropic-versionstring存在时转发给模型,例如 2023-06-01。anthropic-betastring存在时转发给模型。请求体
application/json必填
modelstring必填文本模型 ID,从模型清单里取。它的 supported_endpoints 必须包含这个路径。messagesobject[]必填按时间顺序排列的对话轮次,最早的在前。rolestring必填消息角色,例如 user 或 assistant。contentstring | object[]必填消息文本,或者用内容项数组传多模态输入。max_tokensinteger必填必填的生成 token 上限。streambooleantrue 返回 SSE 事件流,而不是单个 JSON 响应。响应
200消息结果;stream: true 时是 SSE 流。idstringtypestringrolestringmodelstringcontentobject[]typestringtextstringstop_reasonstring | nullusageobjectinput_tokensintegeroutput_tokensinteger{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "Qwen/Qwen3.5-4B",
"content": [
{
"type": "text",
"text": "Hello!"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 16,
"output_tokens": 3
}
}400请求不合法。先改请求再重试:error.code 用于程序判断,error.param 用于定位是哪个输入。401API Key 缺失或无效。403Host 或 Origin 不被允许,或 License 被拒。按 error.code 区分这两种情况。413请求体超过 512 MiB。503所需的本地模型仍在准备(model_downloading),或服务正忙(service_busy)。带 Retry-After 时按它退避。