クイックスタート

RouteAPI は OpenAI 互換、Claude Messages、Google Gemini API に共通の認証入口を提供します。アカウント作成から最初の検証まで進み、用途に合った統合方法を選択できます。

3 つのステップ

アカウントを登録。 RouteAPI コンソールでメールまたは Google から登録します。ダッシュボードで残高、使用量、状態を確認できます。
Token を作成。 Token 管理 → Key を作成を開き、名前と有効期限を入力します。必要に応じてクォータとモデル制限を設定します。
テストを送信。 ROUTEAPI_KEY に Token を設定し、利用可能なモデルで次の cURL を実行します。

リクエストを送信する

最初の確認には OpenAI 互換エンドポイントが便利です。

export ROUTEAPI_KEY="sk-your-routeapi-token"
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":"RouteAPI こんにちは"}]}'

応答にはメッセージと使用量が含まれます。利用可能であれば API またはクライアントが返すリクエスト ID を保存すると、調査に役立ちます。モデルが利用できない場合は GET /v1/models の ID に置き換えてください。

統合方法を選ぶ

直接 API cURL や任意の HTTP クライアントで依存関係なしに呼び出します。

OpenAI 互換 SDK 既存の OpenAI SDK を保ち、API Key と Base URL だけ変更します。

開発ツール Codex、Cursor、Claude Code、OpenCode、LangChain、LiteLLM を設定します。

Node.js と Python

実行環境を選び、対応する公式 OpenAI SDK をインストールして、Base URL を RouteAPI に設定します。

bun add openai
pip install openai

import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.ROUTEAPI_KEY, baseURL: 'https://api.routeapi.ai/v1' });
const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'RouteAPI を一文で紹介してください' }],
});
console.log(response.choices[0].message.content);

Node.js、Python、OpenAI SDK に完全な例があります。

ストリーミング出力

stream: true を指定すると SSE を段階的に受信できます。data: を読み取り、data: [DONE] で終了してください。

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"RouteAPI を 3 点で説明してください"}]}'

ストリーミングと最終使用量はモデルの対応状況に依存します。ストリーミング応答を参照してください。

確認とトラブルシューティング

curl https://api.routeapi.ai/v1/models -H "Authorization: Bearer $ROUTEAPI_KEY"

401：Token と Authorization を確認。
402：残高または Token のクォータを確認。
429：呼び出し頻度を下げる。
502/503：モデルサービスを確認し、再試行回数を制限する。
モデル unavailable：正確な ID と能力を確認する。

リクエスト調査とよくあるエラーも参照してください。コンソールの使用ログには状態、遅延、Token、費用、エラーが記録されます。

次のステップ

API 概要プロトコル、Base URL、ヘッダー、互換性の範囲。

モデルと料金モデル ID、能力、利用状況、現在の料金。

ルーティングとフォールバック本番前にサービス経路と障害保護を理解します。

本番では Token をサーバー側に置き、モデル ID とリクエスト ID を固定・記録し、利用予定のモデルで任意機能を検証してください。