API 参考
API 参考
TokRouter 的端点清单、通用请求头与错误约定。
所有端点共用同一个 origin https://api.tokrouter.dev 与同一把 sk- 令牌。
端点清单
| 方法与路径 | 说明 |
|---|---|
POST /v1/chat/completions | OpenAI Chat Completions,最常用的入口 |
POST /v1/responses | OpenAI Responses API |
POST /v1/messages | Anthropic Messages |
POST /v1beta/models/{model}:generateContent | Gemini 原生(:streamGenerateContent 为流式) |
POST /v1/services/aigc/text-generation/generation | DashScope 原生(去掉官方 /api 前缀) |
POST /v1/systemone | Jev 决策模型透传(不支持流式) |
GET /v1/models | 当前令牌可用的模型列表 |
POST /v2/rerank | 重排序 |
GET /health | 健康检查 |
通用请求头
| 头 | 必填 | 说明 |
|---|---|---|
Authorization: Bearer sk-… | OpenAI / DashScope 协议必填 | 也可用 x-api-key |
x-api-key: sk-… | Anthropic 协议必填 | |
x-goog-api-key: sk-… | Gemini 协议必填 | |
Content-Type: application/json | 是 | |
anthropic-version | Anthropic 协议建议带 | 例如 2023-06-01 |
错误
错误响应的总体约定:
- HTTP 状态码指示类别(
401鉴权、402/403额度或权限、429限流、5xx上游错误) - 响应体是 JSON,字段名随入站协议不同(OpenAI 协议为
{"error":{"message":…,"type":…}}, Anthropic 协议为{"type":"error","error":{"type":…,"message":…}}) - 请求失败不计费
错误细节以上游为准
网关聚合多家上游,具体的错误 type 与 code 取值来自对应厂商,本页不逐一枚举 ——
枚举必然过期。需要精确的错误码时,以响应体里的 error 字段和厂商文档为准。
机器可读的接口描述
本站在 /openapi.yaml 提供 OpenAPI 3.1 描述,适合喂给代码生成器或 agent 工具。