接入文档

稳定的 HTTP 中转接口，同时提供 OpenAI Responses 风格与 Anthropic Messages 风格。使用您的 API Key 鉴权，向下方基础地址发起 请求即可。以下示例中的地址与密钥均为占位符，请替换为您自己的值。

基础地址（Base URL）

https://api.yinghaisheji.top/v1

API Key（密钥）在客户门户签发，仅展示一次，请妥善保存； 服务端只保存其哈希值。

鉴权方式

同时支持 Authorization: Bearer 请求头与 x-api-key 请求头。

Authorization: Bearer YOUR_API_KEY
# 或
x-api-key: YOUR_API_KEY

POST /v1/responses

面向编程类模型的 Responses 风格请求。此线路要求 input 为非空数组、 store: false、 stream: true；请勿发送不受支持的 max_output_tokens 字段。

curl https://api.yinghaisheji.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": [{
      "type": "message",
      "role": "user",
      "content": [{"type": "input_text", "text": "用一句话解释什么是延迟。"}]
    }],
    "store": false,
    "stream": true
  }'

POST /v1/messages

面向推理类模型的 Messages 风格请求（SSE 流式）。

curl https://api.yinghaisheji.top/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好！"}],
    "stream": true
  }'

模型发现

查询您的 Key 当前可用的模型列表，或查看公开目录。

curl "https://api.yinghaisheji.top/v1/models?upstream=codex" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 公开、无需鉴权的价格目录（本站）：
curl /public/api/catalog

不支持的接口

错误码

状态码	含义	处理建议
400	请求参数错误	检查 JSON 请求体、模型名称与必填字段。
401	未鉴权	API Key 缺失或无效。
402	需要付费	预付余额或额度已耗尽，请在门户提交充值申请。
403	无权限	该 Key 未获准调用此接口或模型。
429	请求过于频繁	已触发限流，请退避重试。
503	服务暂不可用	上游容量暂时不可用，请稍后重试。

Grok CLI 接入（headless）

Grok 官方 CLI 可通过本中转站以 headless 模式使用，享受多账号自动换号、 额度耗尽无感切换。

第 1 步 · 设置环境变量（PowerShell）：

$env:GROK_CLI_CHAT_PROXY_BASE_URL = "https://api.yinghaisheji.top/grok/v1"
$env:XAI_API_KEY = "YOUR_API_KEY"
# 切勿设置 GROK_MODELS_BASE_URL —— 会让 CLI 切到 OpenAI /chat/completions 模式导致 404

第 2 步 · 在 ~/.grok/config.toml 末尾追加模型定义 （键名含点号必须加引号，否则 grok-4.5 会被 TOML 截断成 grok-4）：

[model."grok-4.5"]
model = "grok-4.5"
api_backend = "responses"
base_url = "https://api.yinghaisheji.top/grok/v1"
name = "Grok 4.5"
env_key = "XAI_API_KEY"
context_window = 500000

第 3 步 · 验证并使用：

grok models                    # 顶部应显示 "You are using XAI_API_KEY" 并列出 grok-4.5
grok -p "用一句话介绍你自己" -m grok-4.5

# 维持多轮上下文：用 -s 指定会话名，同名续接（headless 默认每次新建会话）
grok -p "第一步" -s mytask -m grok-4.5
grok -p "接着上面继续" -s mytask -m grok-4.5

Headless 每次 -p 为独立进程冷启动（含加载、认证）， 适合脚本 / 批处理 / CI；需要连续高频交互、低延迟的场景请用交互 TUI。

额度说明：当某账号余额耗尽（上游返回 402），中转站会自动标记并切换到下一个 可用账号，客户端无感知；被标记的账号由后台每小时探测，额度恢复后自动重新上线。

一键接入工具

通用版接入工具下载地址： /download/codex-onboarding.exe。 在客户门户签发或轮换 Key 后，还可以立即生成一个 个性化配置包（ZIP，内含接入工具 codex接入工具.exe 与已预填基础地址、密钥的配置文件 gateway-profile.json）。 使用步骤：

1. 下载 ZIP 后先解压，把两个文件放到同一个文件夹 （不要直接在 ZIP 内双击运行，压缩包内直接运行可能无法正确读取配置 文件）；
2. 双击 codex接入工具.exe；
3. 确认程序自动填入的中转站地址与 API Key 无误；
4. 点击"一键接入中转站"完成接入；
5. 接入成功后，删除该 ZIP 文件及解压出的配置文件副本（工具本身也会 尝试自动安全删除已使用过的配置文件）。