API 参考
CodingRouter 兼容 OpenAI、Anthropic、Google 三家的官方接口格式,官方 SDK 改个 Base URL 就能用。本节每个接口一页,参数和示例都经过真实请求验证。
基本信息
| 项目 | 值 |
|---|---|
| Base URL | https://api.codingrouter.ai |
| OpenAI SDK 的 Base URL | https://api.codingrouter.ai/v1 |
| 请求格式 | JSON;上传图片用 multipart/form-data |
| 单个请求体上限 | 256 MB |
接口一览
| 分类 | 接口 | 方法与路径 |
|---|---|---|
| 对话 | Chat Completions | POST /v1/chat/completions |
| 对话 | Responses | POST /v1/responses |
| 对话 | Claude Messages | POST /v1/messages |
| 对话 | Gemini generateContent | POST /v1beta/models/{model}:generateContent |
| 向量 | Embeddings | POST /v1/embeddings |
| 图像 | 图像生成 | POST /v1/images/generations |
| 图像 | 图像编辑 | POST /v1/images/edits |
| 视频 | 视频生成 | POST /v1/videos、GET /v1/videos/{id}、GET /v1/videos/{id}/content |
| 模型 | 模型列表 | GET /v1/models、GET /v1beta/models |
鉴权
在控制台 令牌管理 创建令牌(sk- 开头)。不同接口支持的写法:
| 写法 | 适用接口 |
|---|---|
Authorization: Bearer sk-... | 全部接口 |
x-api-key: sk-... | Claude Messages、/v1/models |
x-goog-api-key: sk-... | Gemini 接口、/v1/models |
URL 参数 ?key=sk-... | Gemini 接口、/v1/models |
令牌只能调用其分组里的模型,见 令牌与分组。
选择接口格式
接口格式和模型厂商不必一致:所有文本模型都能用 Chat Completions 调用,Claude 模型另外支持 Claude Messages,Gemini 模型另外支持 Gemini 原生格式。需要各家的专属能力(Claude 的提示缓存、Gemini 的 thinkingConfig 和图像、语音输出)时,用原生格式。
流式输出
所有对话接口都支持 SSE 流式输出(Content-Type: text/event-stream):
| 接口 | 开启方式 | 结束标志 |
|---|---|---|
| Chat Completions | "stream": true | data: [DONE] |
| Responses | "stream": true | event: response.completed |
| Claude Messages | "stream": true | event: message_stop |
| Gemini | 改调 :streamGenerateContent?alt=sse | 连接关闭 |
生成时间长的请求请优先用流式,或把客户端超时设到 300 秒以上。
流中可能夹有以冒号开头的心跳行(如 : PING),用来保持连接。官方 SDK 会自动忽略;自己解析 SSE 时请跳过这些行。
错误
错误体跟随调用的协议格式,状态码和处理方法见 错误与重试。
