API 概要
RouteAPI は企業向けの統一 AI API 接続機能を提供し、OpenAI、Claude、Gemini、Azure、AWS Bedrock などのモデル機能を、安定して観測可能かつ計量可能な 1 つのインターフェース体系に集約します。業務システムは RouteAPI に接続するだけで、統一認証、統一モデル ID、統一ログのもとで複数のモデルサービスを呼び出せます。
対応しているプロトコル入口
Section titled “対応しているプロトコル入口”RouteAPI は OpenAI 互換、Claude Messages、Google Gemini という 3 つの主要プロトコルに対応しています。既存の SDK やクライアントはそのまま利用でき、Base URL と API Key を RouteAPI に切り替えるだけです。
| プロトコル | 代表的な API | 適したシナリオ |
|---|---|---|
| OpenAI 互換 | /v1/chat/completions、/v1/responses、/v1/embeddings | OpenAI SDK、Cursor、OpenCode、LangChain、LiteLLM などの互換クライアント |
| Claude Messages | /v1/messages | Claude Code、Anthropic SDK、Claude ネイティブメッセージ形式のクライアント |
| Google Gemini | /v1beta/models/{model}:generateContent | Google GenAI SDK、Gemini REST クライアント |
異なるプロトコルから入ったリクエストは、RouteAPI 内部で必要な形式変換が行われます。業務側では、現在のクライアントがネイティブに対応しているプロトコルを優先して選べば十分です。
ベースアドレス
Section titled “ベースアドレス”OpenAI 互換および Claude Messages プロトコルでは、既定で次を使用します。
https://www.routeapi.ai/v1Google Gemini プロトコルでは、既定で次を使用します。
https://www.routeapi.ai/v1beta共通リクエストヘッダー
Section titled “共通リクエストヘッダー”Authorization: Bearer sk-your-routeapi-tokenContent-Type: application/jsonすべてのプロトコルで同じ種類の RouteAPI Token を使用します。Token はサーバー側で保存し、ブラウザ、モバイル端末、公開リポジトリに露出しないでください。
プロトコル互換範囲
Section titled “プロトコル互換範囲”RouteAPI は各プロトコルのネイティブな呼び出し体験をできるだけ維持しつつ、リクエストを適切なモデルサービスへ転送します。実際に利用できる機能は、モデル、サービス機能、リクエストパラメータによって異なります。
| 機能 | 説明 |
|---|---|
| Chat Completions | 推奨される基本チャット API。多くの OpenAI SDK 互換クライアントに適しています。 |
| Responses | OpenAI Responses プロトコルに対応するクライアントやコーディングエージェントに適しています。 |
| Embeddings | ベクトル検索、セマンティック検索、RAG に使用します。 |
| Streaming | SSE を使用して増分内容を返します。 |
| Claude Messages | Claude ネイティブのメッセージ構造に対応し、Claude Code と Anthropic SDK に適しています。 |
| Google Gemini | Gemini generateContent 形式のリクエストに対応します。 |
| Tool Calling | モデルがツール呼び出しに対応しているかに依存します。 |
| Structured Outputs | モデルが JSON mode または JSON Schema に対応しているかに依存します。 |
| Vision / Multimodal | モデルが画像またはマルチモーダル入力に対応しているかに依存します。 |
API 安定性の約束
Section titled “API 安定性の約束”- リクエストパラメータはできるだけ保持され、プロトコルに従って転送されます。
- 任意のスカラー値として
0やfalseが明示的に渡された場合、RouteAPI はそれらを既定値として破棄せず、明示値として扱います。 - モデルによって対応しないパラメータは、互換ルールに基づいて変換、無視、またはエラーになる場合があります。
- 本番環境ではモデル ID を固定し、重要な業務には失敗時の代替策を用意することを推奨します。
- ツール呼び出し、構造化出力、画像入力、ストリーミング使用量集計などの任意機能は、先にテスト環境で検証してから本番投入することを推奨します。
企業接続の推奨事項
Section titled “企業接続の推奨事項”- サーバー側で RouteAPI Token を一元的にラップし、業務フロントエンドが直接キーを保持しないようにします。
- 業務システムごとに異なる Token を使用し、独立した上限管理、監査、問題特定をしやすくします。
- モデル ID とプロトコルパスを固定し、一時的な別名や表示名に依存しないでください。
- リクエスト ID、モデル ID、ステータスコード、所要時間、token 使用量を記録し、レイテンシやコスト異常の調査に役立てます。
- コア業務ではストリーミングタイムアウト、失敗時の再試行、代替モデル案を有効にし、単一モデルサービスの異常が業務に与える影響を抑えます。