API 文档

RouterShift API 概览

RouterShift 提供统一的 OpenAI 兼容 API，可访问来自数十家提供商的数百个 AI 模型。使用单个 API Key 即可跨提供商智能路由请求，内置负载均衡、故障转移和成本优化。

核心功能

OpenAI 兼容 API — 任何 OpenAI SDK 客户端均可即插即用
智能路由，支持可配置策略（加权、轮询、基于延迟、故障转移）
内置断路器和速率限制，保护您的应用
语义缓存，减少重复查询的延迟和成本
全面的日志记录、监控和支出分析
多提供商支持，当提供商不可用时自动故障转移

兼容 OpenAI 协议的 Base URL

与 OpenAI 客户端库完全兼容。只需将 SDK 的 base_url 改为以下地址，配合您的 RouterShift API Key 即可使用。

https://api.routershift.com/v1

兼容 Anthropic 协议的 Base URL

适用于 Anthropic SDK 或 Claude Code。注意：不带 /v1 后缀，SDK 会自动追加 /v1/messages。

https://api.routershift.com

多协议兼容

RouterShift 同时兼容 OpenAI、Anthropic 和 Google Gemini 三种协议。无论您使用哪个 SDK，只需更改 Base URL 即可接入——无需修改代码逻辑。

支持的模型类别

RouterShift 提供来自领先 AI 提供商的聊天、代码生成、视觉、图像生成、推理和音频模型。

获取帮助

如果遇到问题或有疑问，请查看以下各节以获取详细指南。有关账单咨询，请通过控制台联系支持团队。如需实时状态更新，请访问状态页面。

完整端点列表

所有 API 端点均使用统一的基础 URL 和认证方式。一个 API Key 通吃所有端点。

POST/v1/chat/completions

聊天补全（OpenAI 兼容）

POST/v1/messages

消息 API（Anthropic 兼容）

POST/v1/models/gemini/:model/generateContent

Gemini 生成内容

POST/v1/models/gemini/:model/streamGenerateContent

Gemini 流式生成内容

POST/v1/embeddings

文本嵌入向量

POST/v1/images/generations

图片生成

POST/v1/audio/transcriptions

音频转文字

POST/v1/audio/speech

文字转语音

POST/v1/rerank

重排序

POST/v1/midjourney/imagine

Midjourney 图片生成

POST/v1/suno/generate

Suno 音乐生成

POST/v1/batch

批处理

POST/v1/chat/completions/async

异步任务 — 提交

GET/v1/chat/completions/async/:id

异步任务 — 查询状态

GET/v1/chat/completions/async/:id/result

异步任务 — 获取结果

GET/v1/models

模型列表

Method	Path	描述
POST	/v1/chat/completions	聊天补全（OpenAI 兼容）
POST	/v1/messages	消息 API（Anthropic 兼容）
POST	/v1/models/gemini/:model/generateContent	Gemini 生成内容
POST	/v1/models/gemini/:model/streamGenerateContent	Gemini 流式生成内容
POST	/v1/embeddings	文本嵌入向量
POST	/v1/images/generations	图片生成
POST	/v1/audio/transcriptions	音频转文字
POST	/v1/audio/speech	文字转语音
POST	/v1/rerank	重排序
POST	/v1/midjourney/imagine	Midjourney 图片生成
POST	/v1/suno/generate	Suno 音乐生成
POST	/v1/batch	批处理
POST	/v1/chat/completions/async	异步任务 — 提交
GET	/v1/chat/completions/async/:id	异步任务 — 查询状态
GET	/v1/chat/completions/async/:id/result	异步任务 — 获取结果
GET	/v1/models	模型列表

协议对应关系

RouterShift 兼容多种 API 协议。下表列出了各协议对应的基础 URL 和 SDK 配置方式。

OpenAI 兼容

https://api.routershift.com/v1

Models: gpt-4o, claude-sonnet-4-6

Authorization: Bearer

Anthropic 兼容

https://api.routershift.com

Models: claude-sonnet-4-6

x-api-key: sk-xxx

Gemini 原生

https://api.routershift.com/v1

Models: gemini-2.5-flash

Authorization: Bearer

基础 URL	模型参数示例	认证 Header
https://api.routershift.com/v1 标准 OpenAI SDK，只需改 base_url	gpt-4o, claude-sonnet-4-6	Authorization: Bearer
https://api.routershift.com 标准 Anthropic SDK，只需改 base_url	claude-sonnet-4-6	x-api-key: sk-xxx
https://api.routershift.com/v1 Gemini 原生格式，直接调用 generateContent	gemini-2.5-flash	Authorization: Bearer

统一认证

全平台使用统一的认证 Header。支持两种格式，效果完全相同：

OpenAI 兼容格式

Authorization: Bearer sk-xxx

Anthropic 兼容格式

x-api-key: sk-xxx

Method

Path

描述

POST

/v1/chat/completions

聊天补全（OpenAI 兼容）

POST

/v1/messages

消息 API（Anthropic 兼容）

POST

/v1/models/gemini/:model/generateContent

Gemini 生成内容

POST

/v1/models/gemini/:model/streamGenerateContent

Gemini 流式生成内容

POST

/v1/embeddings

文本嵌入向量

POST

/v1/images/generations

图片生成

POST

/v1/audio/transcriptions

音频转文字

POST

/v1/audio/speech

文字转语音

POST

/v1/rerank

重排序

POST

/v1/midjourney/imagine

Midjourney 图片生成

POST

/v1/suno/generate

Suno 音乐生成

POST

/v1/batch

批处理

POST

/v1/chat/completions/async

异步任务 — 提交

GET

/v1/chat/completions/async/:id

异步任务 — 查询状态

GET

/v1/chat/completions/async/:id/result

异步任务 — 获取结果

GET

/v1/models

模型列表

基础 URL

模型参数示例

认证 Header

https://api.routershift.com/v1

标准 OpenAI SDK，只需改 base_url

gpt-4o, claude-sonnet-4-6

Authorization: Bearer

https://api.routershift.com

标准 Anthropic SDK，只需改 base_url

claude-sonnet-4-6

x-api-key: sk-xxx

https://api.routershift.com/v1

Gemini 原生格式，直接调用 generateContent

gemini-2.5-flash

Authorization: Bearer