全部文档
当前文档
最近更新时间：2026-10-14 15:40:56
Anthropic Messages 接口是 Anthropic 推出的标准对话协议（端点 /v1/messages），与 Claude API 兼容。星流平台完整支持该协议。本文档介绍协议差异点、流式事件、参数、错误码，便于从 Anthropic SDK 迁移或在 Claude Code / Cline / Cursor 等原生支持 Anthropic 协议的客户端中接入。
项目 | 值 |
|---|---|
端点 |
|
认证 |
|
请求体格式 | JSON |
适用客户端 | Claude Code、Cline、Cursor、Continue、LangChain 、Anthropic 官方 SDK 等 |
客户端 |
|
客户端 API Key | 在控制台「API Key 管理」创建的星流平台 API Key |
与 OpenAI Chat Completions 协议相比，Anthropic Messages 的关键差异是 messages[].role 仅支持 user / assistant；系统提示词作为独立的顶层 system 字段传入。
curl -X POST https://kspmas.ksyun.com/v1/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
"model": "deepseek-v4.1-flash",
"max_tokens": 512,
"messages": [
{"role": "user", "content": "你好"}
]
}'{
"id": "msg_01Hxxxxxxxxxxxxxxxxxxxxxxx",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "你好！有什么可以帮你的吗？"
}
],
"model": "deepseek-v4.1-flash",
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 8,
"output_tokens": 12,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}将 stream 字段设为 true 即可启用流式响应，平台使用 Server-Sent Events 推送事件序列。
curl -X POST https://kspmas.ksyun.com/v1/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
"model": "deepseek-v4.1-flash",
"max_tokens": 1024,
"stream": true,
"messages": [
{"role": "user", "content": "你好"}
]
}'按发生顺序依次返回：
event: message_start
data: {"type":"message_start","message":{"id":"msg_...","type":"message","role":"assistant","content":[],"model":"deepseek-v4.1-flash","stop_reason":null,"usage":{"input_tokens":8,"output_tokens":1}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"你好"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"！"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":4}}
event: message_stop
data: {"type":"message_stop"}事件类型：
事件 | 触发时机 |
|---|---|
| 消息开始，携带初始 |
| 新的内容块开始（ |
| 内容块增量更新（ |
| 当前内容块结束 |
| 消息级增量（含 |
| 消息结束，流式以此事件为终止 |
HTTP 状态码 | 含义 | 排查方向 |
|---|---|---|
| 请求参数错误（如 | 检查请求体是否符合 Anthropic 协议规范（如 |
| 鉴权失败 | 检查 |
| 模型未开通 | 提示 |
| 模型在 Anthropic 端点未注册 | 当前模型不支持Anthropic协议 |
| 请求体过大（超过 | 减少输入长度或换用更大上下文的模型 |
| 触发限流（RPM / TPM 超出） | 提示 |
| 上游服务异常 | 稍后重试 |
| 服务过载 | 稍后重试 |
纯净模式