API 参考

本站中转的全部路由、密钥怎么传、错误长什么样、有哪些限额。

端点

路由	作用
POST `/v1/chat/completions`	OpenAI Chat Completions；流式时自动带回用量。
POST `/v1/responses`	OpenAI Responses API，Codex 使用。
POST `/v1/embeddings`	Embedding，提供该能力的模型可用。
POST `/v1/messages`	Anthropic Messages，Claude Code 与 Claude Desktop 使用。
POST `/v1/messages/count_tokens`	计算 token，从不计费。
POST `/v1beta/models/{model}:generateContent`	Gemini 原生接口，一次返回。
POST `/v1beta/models/{model}:streamGenerateContent?alt=sse`	Gemini 原生接口，以 SSE 流式返回。
GET `/v1/models` · GET `/v1beta/models`	OpenAI 与 Gemini 格式的模型列表；需要密钥，不计费。

怎么传密钥

使用 Authorization: Bearer、x-api-key 或 x-goog-api-key；Gemini 客户端也可以在网址后加 ?key=，转发前会去掉。

curl · Gemini

curl --request POST "https://api.coderelayhub.com/v1beta/models/gemini-3.8-flash:generateContent" \
  --header "x-goog-api-key: crh_paste_your_key_here" --header "Content-Type: application/json" \
  --data '{"contents":[{"role":"user","parts":[{"text":"Summarize git rebase in one line"}]}]}'

错误码

每次调用按上游回报的 token 计费；出错时按 OpenAI 的错误结构返回。

HTTP	type	在本站的含义
`400`	`invalid_request_error` · `model_not_found`	请求格式不对、缺少 model、模型不存在，或模型走错了协议。
`401`	`authentication_error`	没带 API 密钥，或密钥不存在、已吊销。
`402`	`insufficient_quota`	余额为零（按量密钥），或对应月卡已用完——充值后即可继续。
`403`	`permission_error`	账户已被停用，或月卡密钥调用了其他族的模型。
`413`	`invalid_request_error`	请求体超过 25 MB。
`429`	`rate_limit_error`	单个密钥每分钟超过 120 次，或账户已有 8 个请求在途。
`502`	`api_error`	暂时连不上上游，本次不计费。

限额

每个密钥滚动一分钟内最多 120 次请求。
每个账户同时在途最多 8 个请求。
单个请求体最大 25 MB；长时间流式不会被超时截断。