# 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":…}}`)
- 请求失败不计费

<Callout type="warn" title="错误细节以上游为准">
网关聚合多家上游,具体的错误 `type` 与 `code` 取值来自对应厂商,本页不逐一枚举 ——
枚举必然过期。需要精确的错误码时,以响应体里的 `error` 字段和[厂商文档](/zh/guides/protocol-interop/)为准。
</Callout>

## 机器可读的接口描述

本站在 `/openapi.yaml` 提供 OpenAPI 3.1 描述,适合喂给代码生成器或 agent 工具。