Skip to main content
RuAPI 同时支持两种 API 协议:经典的 OpenAI 兼容,和原生 Anthropic Claude 兼容。同一把 API key 在两边都能用

OpenAI 协议

POST /v1/chat/completions —— 行业标准,几乎所有 SDK 和框架都支持。

Claude 协议

POST /v1/messages —— Anthropic 原生格式,支持 thinking 块和 MCP。
速查:

基础 URL

地址取决于协议 —— 这是最容易填错的地方: OpenAI 兼容 —— 带 /v1
Anthropic —— 不带 /v1(SDK 会自动补 /v1/messages):
下方端点表里的路径都是从域名根写全的。鉴权通过 Authorization: Bearer sk-... 头(/v1/messagesx-api-key 也可)。
Anthropic 的 base_url 不要/v1 —— 多写一个 /v1 会导致 404

OpenAI 协议

如果你的代码已经在用 OpenAI 官方 SDK 或兼容框架(LangChain、LlamaIndex、Vercel AI SDK 等),用这个协议。

端点

兼容性

请求/响应格式与 OpenAI Chat Completions API 完全一致。支持:
  • messages(角色 system / user / assistant / tool
  • model —— 模型库里任意模型名(包括 Claude/Gemini/Grok/Qwen/MiniMax/GLM,我们会自动转换协议)
  • stream: true 流式响应(Server-Sent Events)
  • tools / tool_choice —— function calling
  • temperaturetop_pmax_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: true
  • tools / tool_choice
  • thinking —— 推理模型的思考模式

Python 示例(Anthropic SDK)

Node.js 示例(Anthropic SDK)

curl 示例

Anthropic SDK 用的是 x-api-key 头,不是 Authorization: Bearer。RuAPI 在 /v1/messages 端点上 两种头都接受

该选哪个协议

不管哪个 —— 同一把 API key,token 同价,余额同账户。

全部端点

完整带模型清单的列表在 首页 → 价格 页看。