API 概要

RouteAPI は企業向けの統一 AI API 接続機能を提供し、OpenAI、Claude、Gemini、Azure、AWS Bedrock などのモデル機能を、安定して観測可能かつ計量可能な 1 つのインターフェース体系に集約します。業務システムは RouteAPI に接続するだけで、統一認証、統一モデル ID、統一ログのもとで複数のモデルサービスを呼び出せます。

3 ステップで始める

すでに何らかの OpenAI 互換 SDK を使っているなら、2 つの設定を変えるだけで動かせます。

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

Base URL を https://api.routeapi.ai/v1 に変更します。
API Key を RouteAPI Token に変更します（コンソールの API Keys ページで作成）。
model をアカウントで利用可能なモデル ID に変更します。GET /v1/models で確認できます。

既存の OpenAI アプリケーションの完全な切り替え手順は、OpenAI からの移行を参照してください。

対応しているプロトコル入口

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 内部で必要な形式変換が行われます。業務側では、現在のクライアントがネイティブに対応しているプロトコルを優先して選べば十分です。ネイティブプロトコルは変換を経ないため、動作が最も予測しやすくなります。プロトコルをまたぐ呼び出し（例えば OpenAI 形式で Claude モデルを呼び出す場合）のマッピングルールと既知の制限については、プロトコル変換の説明を参照してください。

ベースアドレス

OpenAI 互換および Claude Messages プロトコルでは、既定で次を使用します。

https://api.routeapi.ai/v1

Google Gemini プロトコルでは、既定で次を使用します。

https://api.routeapi.ai/v1beta

共通リクエストヘッダー

Authorization: Bearer sk-your-routeapi-token
Content-Type: application/json

すべてのプロトコルで同じ種類の RouteAPI Token を使用します。Token はサーバー側で保存し、ブラウザ、モバイル端末、公開リポジトリに露出しないでください。キーの権限、クォータ、認証エラーの詳細は認証方式を参照してください。

Claude Messages プロトコルは、Anthropic SDK でよく使われる x-api-key リクエストヘッダーも受け付けます。そのため Anthropic SDK を使う場合、通常は Base URL を変更するだけで済みます。

API と機能のインデックス

やりたいことに応じて入口を選んでください。

やりたいこと	使う API	ドキュメント
通常のマルチターン対話	`/v1/chat/completions`	Chat Completions
コーディングエージェント、新プロトコルのクライアント	`/v1/responses`	Responses
ベクトル検索、セマンティック検索、RAG	`/v1/embeddings`	Embeddings
利用可能なモデルと機能を照会	`/v1/models`	Models
モデルに外部関数を呼び出させる	`tools` パラメータ	ツール呼び出し
モデルに固定の JSON 構造で出力させる	`response_format` パラメータ	構造化出力
画像をモデルに渡して理解させる	マルチモーダル `content`	マルチモーダル入力
逐次返却で最初の文字までの遅延を下げる	`stream: true`	ストリーミング
AI 音楽生成	Suno REST API	Suno API

プロトコル互換範囲

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 でも model を切り替えると、ツール呼び出しや画像入力に対応しなくなる場合があります。本番投入前に対象モデルで実際に検証するか、Models が返す機能フィールドを確認してください。

API 安定性の約束

リクエストパラメータはできるだけ保持され、プロトコルに従って転送されます。
任意のスカラー値として 0 や false が明示的に渡された場合、RouteAPI はそれらを既定値として破棄せず、明示値として扱います。
モデルによって対応しないパラメータは、互換ルールに基づいて変換、無視、またはエラーになる場合があります。
本番環境ではモデル ID を固定し、重要な業務には失敗時の代替策を用意することを推奨します。
ツール呼び出し、構造化出力、画像入力、ストリーミング使用量集計などの任意機能は、先にテスト環境で検証してから本番投入することを推奨します。

企業接続の推奨事項

サーバー側で RouteAPI Token を一元的にラップし、業務フロントエンドが直接キーを保持しないようにします。
業務システムごとに異なる Token を使用し、独立した上限管理、監査、問題特定をしやすくします。
モデル ID とプロトコルパスを固定し、一時的な別名や表示名に依存しないでください。
リクエスト ID、モデル ID、ステータスコード、所要時間、token 使用量を記録し、レイテンシやコスト異常の調査に役立てます。
コア業務ではストリーミングタイムアウト、失敗時の再試行、代替モデル案を有効にし、単一モデルサービスの異常が業務に与える影響を抑えます。

次のステップ

認証方式 — Token の作成、クォータと権限の設定。
エラーとデバッグ — ステータスコードの意味と調査の進め方。
OpenAI からの移行 — 既存アプリケーションの切り替えチェックリスト。
クライアント接続 — Cursor、Claude Code、LangChain などの具体的な設定。
課金とクォータ — 使用量統計と課金の考え方。