アプリとコーディングエージェントを接続

Route Key APIキーひとつで、アプリ、SDK、コーディングツールを互換ゲートウェイに接続します。

ステップ 01

AIアプリを接続

3つの値で最初の互換リクエストを送信できます。

  • Base URLhttps://api.routekey.ai/v1
  • AuthorizationBearer YOUR_ROUTEKEY_API_KEY
  • モデルModelsから有効なIDを選択
最初の動作リクエスト
curl https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ROUTEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<route-key-model>","messages":[{"role":"user","content":"Hello"}]}'
ステップ 02

コーディングエージェントを設定

ツールごとに専用キーを使い、対応する設定プロファイルをコピーします。

Install Codex公式ドキュメント
npm install -g @openai/codex
~/.codex/config.toml
model = "<route-key-coding-model>"
model_provider = "routekey"

[model_providers.routekey]
name = "Route Key"
base_url = "https://api.routekey.ai/v1"
env_key = "ROUTEKEY_API_KEY"
  • 専用のRoute Key APIキーを作成
  • Modelsから有効なモデルを選択
  • ツールを再起動して利用ログを確認
運用チェックリスト

統合を保守しやすく保つ

OpenAI互換性で移行は簡単になりますが、ツールごとのキー、検証済みモデル、設定可能なbase URLが必要です。 モデル.

安全で再現可能なAPI接続を準備

APIキーを作成して保護

Dashboardでキーを作成し、アプリやツールごとに専用キーを使います。環境変数やシークレット管理に保存し、コードやログに公開しないでください。

リクエストの3つの値

base URLはゲートウェイ、Bearerトークンは認証、モデルIDは有効なモデルを指定します。Modelsページの正確なIDを使ってください。 モデル.

本番展開前にアクセスを確認

残高またはクォータ、モデルのグループ、endpointの対応を確認します。短い非ストリーミングリクエストが原因の切り分けに最適です。

最初の応答と利用ログを確認
  1. 短いリクエストを送り、通常の応答またはストリームを確認します。
  2. 応答したモデルIDとendpointを記録して再現できるようにします。
  3. 利用ログでリクエスト、トークン、レイテンシ、コストを確認します。
  4. streaming、ツール、長いコンテキスト、同時実行を一つずつ追加します。

401または403の認証エラー

Authorization: Bearer、余分な空白、キーの状態、/v1 base URLを確認してください。

モデルが見つからない、または利用不可

Modelsから有効なモデルIDをコピーし、グループとendpointを確認してください。

クォータ、残高、レートのエラー

ウォレット、アカウント制限、利用ログを確認し、テストの同時実行や出力を減らします。

既存のOpenAI SDKを使えますか?

通常は使えます。SDK形式を保ち、base URLをRoute Key /v1にし、Route Key APIキーを渡してください。

複数のツールで1つのキーを共有すべきですか?

いいえ。アプリやエージェントごとのキーでログ確認とローテーションが安全になります。

コスト差はどこで調べますか?

利用ログでモデル、グループ倍率、入出力トークン、endpoint、時刻を比較し、価格カタログを確認します。