OpenAI 协议
POST /v1/chat/completions——行业标准,几乎所有 SDK 和框架都支持。Claude 协议
POST /v1/messages——Anthropic 原生格式,支持 thinking 块和 MCP。基础 URL
地址取决于协议——这是最容易填错的地方: OpenAI 兼容——带/v1:
/v1(SDK 会自动补 /v1/messages):
Authorization: Bearer sk-... 头(/v1/messages 上 x-api-key 也可)。
OpenAI 协议
如果你的代码已经在用 OpenAI 官方 SDK 或兼容框架(LangChain、LlamaIndex、Vercel AI SDK 等),用这个协议。请求地址
兼容性
请求/响应格式与 OpenAI Chat Completions API 完全一致。支持:messages(角色system/user/assistant/tool)model——模型库里任意模型名(包括 Claude/Gemini/DeepSeek/Qwen/GLM,我们会自动转换协议)stream: true流式响应(Server-Sent Events)tools/tool_choice—— function callingtemperature、top_p、max_tokens等参数
Python 示例(OpenAI SDK)
Node.js 示例(OpenAI SDK)
curl 示例(带 streaming)
Claude 协议
如果你的代码用 Anthropic SDK,或者你需要 Claude 特有的功能(thinking 块、原生格式 tool calls),用这个协议。请求地址
兼容性
请求/响应格式与 Anthropic Messages API 完全一致。支持:messages数组(Claude 原生格式)system作为单独字段model——Claude 模型名或其他(我们会转成 Claude 协议)max_tokens(Claude 必填)stream: truetools/tool_choicethinking——推理模型的思考模式
Python 示例(Anthropic SDK)
Node.js 示例(Anthropic SDK)
curl 示例
Anthropic SDK 用的是
x-api-key 头,不是 Authorization: Bearer。RuAPI 的 /v1/messages 两种头都接受。该选哪个协议
不管哪个——同一把 API key,token 同价,余额同账户。
全部接口地址
嵌入请求示例: