ステップ 01AIアプリを接続
3つの値で最初の互換リクエストを送信できます。
- Base URL
https://api.routekey.ai/v1 - Authorization
Bearer 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"}]}'
運用チェックリスト統合を保守しやすく保つ
OpenAI互換性で移行は簡単になりますが、ツールごとのキー、検証済みモデル、設定可能なbase URLが必要です。 モデル.
安全で再現可能なAPI接続を準備
APIキーを作成して保護
Dashboardでキーを作成し、アプリやツールごとに専用キーを使います。環境変数やシークレット管理に保存し、コードやログに公開しないでください。
リクエストの3つの値
base URLはゲートウェイ、Bearerトークンは認証、モデルIDは有効なモデルを指定します。Modelsページの正確なIDを使ってください。 モデル.
本番展開前にアクセスを確認
残高またはクォータ、モデルのグループ、endpointの対応を確認します。短い非ストリーミングリクエストが原因の切り分けに最適です。
最初の応答と利用ログを確認
- 短いリクエストを送り、通常の応答またはストリームを確認します。
- 応答したモデルIDとendpointを記録して再現できるようにします。
- 利用ログでリクエスト、トークン、レイテンシ、コストを確認します。
- streaming、ツール、長いコンテキスト、同時実行を一つずつ追加します。
401または403の認証エラー
Authorization: Bearer、余分な空白、キーの状態、/v1 base URLを確認してください。
モデルが見つからない、または利用不可
Modelsから有効なモデルIDをコピーし、グループとendpointを確認してください。
クォータ、残高、レートのエラー
ウォレット、アカウント制限、利用ログを確認し、テストの同時実行や出力を減らします。
既存のOpenAI SDKを使えますか?
通常は使えます。SDK形式を保ち、base URLをRoute Key /v1にし、Route Key APIキーを渡してください。
複数のツールで1つのキーを共有すべきですか?
いいえ。アプリやエージェントごとのキーでログ確認とローテーションが安全になります。
コスト差はどこで調べますか?
利用ログでモデル、グループ倍率、入出力トークン、endpoint、時刻を比較し、価格カタログを確認します。