RouterShiftRouterShift
浏览模型定价文档
RouterShiftRouterShiftRouterShift. 企业级 AI 基础设施。
浏览模型状态文档条款隐私数据处理协议透明度

API 文档

API 参考

RouterShift API 概览

RouterShift 提供统一的多协议 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

多协议兼容

现有 OpenAI、Anthropic 与 Gemini 客户端通常只需调整 Base URL 与凭据即可接入；具体字段和路由以在线 OpenAPI 为准，不应假设所有上游扩展都可移植。

支持的模型类别

GET /v1/models 是当前 Key 可调用模型的权威来源；可用性还受商品激活、路由健康、权限、余额、区域与私有接入策略影响。

获取帮助

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

完整端点列表

下表是公开数据面的人工索引；机器契约以 /api/openapi.yaml 为准，交互式文档位于 /api/docs，且每个端点和模型仍受 Key 权限约束。

GET/v1/version

数据面 API 版本与兼容性信息

GET/v1/models

模型列表

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/rerank

重排序

POST/v1/chat/completions/estimate

请求前 Token 与费用预估

POST/v1/images/generations

图片生成

POST/v1/audio/transcriptions

音频转文字

POST/v1/audio/speech

文字转语音

POST/v1/tts

扩展文字转语音

POST/v1/transcriptions

扩展音频转写

POST/v1/midjourney/imagine

Midjourney 图片生成

POST/v1/suno/generate

Suno 音乐生成

POST/v1/video/generations

视频生成任务

GET/v1/video/tasks/:task_id

视频生成任务状态

POST/v1/chat/completions/async

异步任务 — 提交

GET/v1/chat/completions/async/:task_id

异步任务 — 查询状态

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

异步任务 — 获取结果

POST/v1/batch

批处理

GET/v1/batch/:batch_id

批处理任务状态

GET/v1/batch/:batch_id/results

批处理结果下载

POST/v1/batch/:batch_id/cancel

取消批处理任务

POST/v1/mcp/

MCP JSON-RPC 工具网关

GET/v1/mcp/sse

MCP SSE 传输

POST/v1/a2a/

A2A JSON-RPC 网关

GET/v1/a2a/sse

A2A SSE 事件流

方法路径描述
GET/v1/version数据面 API 版本与兼容性信息
GET/v1/models模型列表
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/rerank重排序
POST/v1/chat/completions/estimate请求前 Token 与费用预估
POST/v1/images/generations图片生成
POST/v1/audio/transcriptions音频转文字
POST/v1/audio/speech文字转语音
POST/v1/tts扩展文字转语音
POST/v1/transcriptions扩展音频转写
POST/v1/midjourney/imagineMidjourney 图片生成
POST/v1/suno/generateSuno 音乐生成
POST/v1/video/generations视频生成任务
GET/v1/video/tasks/:task_id视频生成任务状态
POST/v1/chat/completions/async异步任务 — 提交
GET/v1/chat/completions/async/:task_id异步任务 — 查询状态
GET/v1/chat/completions/async/:task_id/result异步任务 — 获取结果
POST/v1/batch批处理
GET/v1/batch/:batch_id批处理任务状态
GET/v1/batch/:batch_id/results批处理结果下载
POST/v1/batch/:batch_id/cancel取消批处理任务
POST/v1/mcp/MCP JSON-RPC 工具网关
GET/v1/mcp/sseMCP SSE 传输
POST/v1/a2a/A2A JSON-RPC 网关
GET/v1/a2a/sseA2A SSE 事件流

协议对应关系

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

OpenAI 兼容

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer / x-api-key

Anthropic 兼容

https://api.routershift.com

Models: <available-model-code>

x-api-key: sk-xxx

Gemini 原生

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer

基础 URL模型参数示例认证 Header
https://api.routershift.com/v1
标准 OpenAI SDK，只需改 base_url
<available-model-code>Authorization: Bearer / x-api-key
https://api.routershift.com
标准 Anthropic SDK，只需改 base_url
<available-model-code>x-api-key: sk-xxx
https://api.routershift.com/v1
Gemini 原生格式，直接调用 generateContent
<available-model-code>Authorization: Bearer

统一认证

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

OpenAI 兼容格式

Authorization: Bearer sk-xxx

Anthropic 兼容格式

x-api-key: sk-xxx