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 通吃所有端点。

MethodPath描述
POST/v1/chat/completions聊天补全（OpenAI 兼容）
POST/v1/messages消息 API（Anthropic 兼容）
POST/v1/models/gemini/:model/generateContentGemini 生成内容
POST/v1/models/gemini/:model/streamGenerateContentGemini 流式生成内容
POST/v1/embeddings文本嵌入向量
POST/v1/images/generations图片生成
POST/v1/audio/transcriptions音频转文字
POST/v1/audio/speech文字转语音
POST/v1/rerank重排序
POST/v1/midjourney/imagineMidjourney 图片生成
POST/v1/suno/generateSuno 音乐生成
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 配置方式。

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

统一认证

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

OpenAI 兼容格式

Authorization: Bearer sk-xxx

Anthropic 兼容格式

x-api-key: sk-xxx