OctaRouter

API 协议

OctaRouter 提供 三种 HTTP 协议。它们不是三家供应商，而是用同一把 API Key 调用同一网关的三种方式。

透传： OctaRouter 把兼容请求转发给上游供应商。使用 OctaRouter 的 Base URL 和你的 API Key；全部请求/响应参数请遵循下方链接的 官方供应商文档。

协议概览

协议Base URL端点适用场景
OpenAI 兼容https://api.octarouter.com/v1POST /chat/completions所有模型的默认协议。 当你的工具期望 OpenAI Chat Completions，或不确定该用哪种时使用。
Anthropic Messageshttps://api.octarouter.comPOST /v1/messagesClaude 模型，且 SDK / Agent 已使用 Anthropic 协议。
Gemini generateContenthttps://api.octarouter.comPOST /v1beta/models/{model}:generateContentGemini / Google 模型，且客户端是 Gemini 原生协议。

调用前请先在 模型 页选择模型 ID。

OpenAI 兼容（默认）

鉴权

Authorization: Bearer YOUR_API_KEY

最小示例

curl "https://api.octarouter.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-or-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

官方文档： OpenAI Chat Completions API

图像、转写与语音（OpenAI 兼容）

这些能力共用 OpenAI 兼容 Base URL（https://api.octarouter.com/v1）和你的 API Key。计费来自各模型的 pricing_profile（不要默认当成单一 $/1M）：

能力端点计费方式
图像生成POST /images/generations图像 Token 或 按张（n=1）
语音转文字POST /audio/transcriptions（multipart file）按秒 或音频 Token
文字转语音POST /audio/speech按上游 usage.characters 按字符（缺少 usage 则不计费）

Playground 使用同样的路径。额外字段请遵循官方 OpenAI Images / Audio 文档；OctaRouter 会转发兼容参数。

Anthropic Messages

使用网关 根 URL（不要加 OpenAI 的 /v1 前缀作为 Base）。

请求头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
anthropic-version: 2023-06-01

最小示例

curl "https://api.octarouter.com/v1/messages" \
  -H "Authorization: Bearer sk-or-..." \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-5-sonnet-latest",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

官方文档： Anthropic Messages API

Gemini generateContent

最小示例

curl "https://api.octarouter.com/v1beta/models/gemini-2.0-flash:generateContent" \
  -H "Authorization: Bearer sk-or-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

官方文档： Gemini API REST reference

进阶：以编程方式列出模型

如果你的集成需要在运行时获取模型 ID（而不是只用模型页）：

  • OpenAI 兼容： GET https://api.octarouter.com/v1/models，并带上 Authorization: Bearer YOUR_API_KEY
  • SDK 客户端： 把 OpenAI SDK 指向 https://api.octarouter.com/v1，然后调用 client.models.list()

请求中使用这些端点返回的模型 ID。