Skip to content

API 参考 ​

CodingRouter 兼容 OpenAI、Anthropic、Google 三家的官方接口格式,官方 SDK 改个 Base URL 就能用。本节每个接口一页,参数和示例都经过真实请求验证。

基本信息 ​

项目值
Base URLhttps://api.codingrouter.ai
OpenAI SDK 的 Base URLhttps://api.codingrouter.ai/v1
请求格式JSON;上传图片用 multipart/form-data
单个请求体上限256 MB

接口一览 ​

分类接口方法与路径
对话Chat CompletionsPOST /v1/chat/completions
对话ResponsesPOST /v1/responses
对话Claude MessagesPOST /v1/messages
对话Gemini generateContentPOST /v1beta/models/{model}:generateContent
向量EmbeddingsPOST /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": truedata: [DONE]
Responses"stream": trueevent: response.completed
Claude Messages"stream": trueevent: message_stop
Gemini改调 :streamGenerateContent?alt=sse连接关闭

生成时间长的请求请优先用流式,或把客户端超时设到 300 秒以上。

流中可能夹有以冒号开头的心跳行(如 : PING),用来保持连接。官方 SDK 会自动忽略;自己解析 SSE 时请跳过这些行。

错误 ​

错误体跟随调用的协议格式,状态码和处理方法见 错误与重试。