// DOCS

API 文档

客户端调用 Claude / GPT / DeepSeek / 豆包 / 千问 的统一中转 API。

快速开始

只需 3 步即可发起第一次调用。

  1. 1

    获取 API Key

    到「API Keys」页创建一个 Key。Key 仅在创建时显示一次,务必复制保存。

  2. 2

    配置 base_url

    把客户端 SDK / 工具的 base_url 改为下方地址:

    Base URLhttps://relay.onemake.dev
  3. 3

    发起请求

    按所用客户端的协议格式调用,鉴权头按协议格式不同。

两种协议

同一个 relay key 同时支持两种协议,按客户端调用路径自动适配,无需创建多个 key。

Anthropic

Claude 官方 SDK / Claude Code / 任何 anthropic-sdk 兼容工具直接配 base_url 即用。

端点
POST /v1/messages
鉴权
x-api-key: rk-...
适用
Claude 系列模型

OpenAI 兼容

GPT / DeepSeek / 豆包 / 千问 等模型走这个协议,任何 openai-sdk 兼容工具配 base_url 即用。

端点
POST /v1/chat/completions
鉴权
Authorization: Bearer rk-...
适用
GPT / DeepSeek / 国产模型

调用示例

把 rk-YOUR_KEY 换成实际的 relay key。模型名称见下方「支持的模型」。

Anthropic — /v1/messages

POST /v1/messages
bash
curl https://relay.onemake.dev/v1/messages \
  -H "x-api-key: rk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

OpenAI 兼容 — /v1/chat/completions

POST /v1/chat/completions
bash
curl https://relay.onemake.dev/v1/chat/completions \
  -H "Authorization: Bearer rk-YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

支持的模型

具体可用模型列表与价格在「模型定价」面板,以下仅列举常用入口。

Anthropic
claude-opus-4-7claude-sonnet-4-5-20250929claude-haiku-4-5-20251001
OpenAI
gpt-5.5gpt-5.4gpt-5.4-mini
DeepSeek
deepseek-v4-flashdeepseek-v4-pro
Doubao
doubao-seed-2-0-pro-260215doubao-seed-2-0-mini-260428
Qwen
qwen-maxqwen-plusqwen-turboqwen-flash

错误码与速率限制

响应统一 {code,msg,data} 结构。code=0 成功,非 0 失败,msg 直显给用户。HTTP 429 = 速率限制,HTTP 401 = key 失效或额度耗尽,HTTP 503 + code=-1 = 维护模式。