OpenRouter API 本番環境チェックリスト

API互換性とエンドポイントの確認

信頼性の高い統合のために、標準のOpenAI互換エンドポイントを使用してください。

主なエンドポイントは POST /v1/chat/completionsこれはチャット履歴のテキスト生成を処理します。2つ目のエンドポイント、 GET /v1/models利用可能なモデルを一覧表示します。テキストのみのタスクには埋め込みや画像生成エンドポイントが必要です。多くの開発者は複雑なルーティングレイヤーが必要だと考えがちです。OpenRouterは単一のエントリポイントを提供することでこれを簡素化します。モデルIDとシステムプロンプトを含むJSONペイロードを送信します。サービスはコンテンツと使用データを含む構造化JSONを返します。この設計は公式のOpenAI SDKの期待に一致します。クライアントコードを変更せずにモデルを切り替えることができます。設定内のモデルIDを更新するだけです。クライアントが最新のJSONスキーマをサポートしていることを確認してください。古いバージョンは新しいパラメータを拒否する可能性があります。本番環境にデプロイする前に接続をテストしてください。レスポンス形式がパーサーと一致することを確認してください。

認証とキーの構成

APIキーは生成直後に環境変数に安全に保存してください。

プロバイダーダッシュボードを通じてキーを生成します。安全な場所に保管してください。ソースリポジトリにハードコードしないでください。 Authorization: Bearer <key> header. 各キーは特定のアカウントに紐付いています。漏洩の疑いがある場合、キーをローテーションできます。一部のプロバイダーでは1つのアカウントに複数のキーを許可しており、これにより開発用と本番用のトラフィックを分離できます。キーごとに使用状況を監視して異常を検知します。使用していないキーは定期的に失効させてください。一時スクリプトには有効期間の短いキーを使用してください。これにより、コンプライアンス発生時の影響範囲を制限できます。SDKのバージョンがBearerトークン認証をサポートしていることを確認してください。古いライブラリでは異なるヘッダー形式が必要になる場合があります。特定のSDKのドキュメントを確認してください。キーに十分な残高があることを確認してください。期限切れのキーは401エラーを返します。残高が0のキーは402エラーを返します。これらの2つの状態をロジックで区別してください。

ストリーミングとトークン使用量の処理

低レイテンシとリアルタイムのユーザーフィードバックのためにストリーミングを有効にします。

設定 stream: true リクエストペイロードに指定します。サーバーは一連のServer-Sent Events (SSE)を送信します。各イベントにはテキストの部分的なチャンクが含まれます。これらのチャンクを組み合わせて完全なレスポンスを形成する必要があります。最終チャンクにはトークン使用統計が含まれることがよくあります。これにより、リアルタイムでコストを追跡できます。ストリーミングなしでは、完全なレスポンスを待つ必要があります。これにより知覚遅延が大幅に増加します。ストリーミングはチャットインターフェースに不可欠です。それは応答性のあるタイピング効果を生み出します。ストリーミング中のエラー処理には注意してください。接続が切れると、現在のチャンクが失われます。再接続ロジックは会話状態を保持すべきです。一部のSDKはストリーミングを自動的に処理します。他のSDKでは手動のイベントリスナーが必要です。アーキテクチャに合ったアプローチを選択してください。パーサーが不完全なJSONチャンクを処理できることを確認してください。各イベントが完全なオブジェクトであると想定しないでください。有効な構造が得られるまでデータをバッファリングしてください。

レート制限と同時実行数の監視

1分あたりのリクエスト数を追跡して、サービスの中断を避けてください。

OpenRouterはAPIキーごとに厳格なレート制限を適用します。制限を超えると、429 Too Many Requestsエラーが発生します。リトライロジックには指数関数的バックオフを実装する必要があります。同時リクエストも制限対象となります。残りのクォータはレスポンスヘッダーで確認してください。一部のプロバイダーはこれらのヘッダーを直接公開しています。他のプロバイダーでは、エラーから制限を推測する必要があります。高い同時実行数は接続プールを枯渇させる可能性があります。クライアントが接続を効率的に管理していることを確認してください。オーバーヘッドを減らすために接続プーリングを使用してください。ピーク時のキュー深度を監視してください。制限に達した場合は、再試行する前に待機してください。待機時間をランダム化して、サーダリングヘルム問題を回避してください。デバッグのためにすべてのレート制限イベントをログに記録してください。これにより、使用パターンの特定に役立ちます。これらのログに基づいて同時実行数の設定を調整してください。単一のキーで無限のトラフィックを処理できるとは限らないと想定してください。必要に応じて、複数のキー間で負荷を分散してください。これには慎重な状態管理が必要です。必要に応じて、各キーが独自のコンテキストを維持していることを確認してください。

暗号通貨課金とチャージの管理

月額料金なしでトークン使用量をカバーするために前払いクレジットをご利用ください。

暗号通貨でアカウントにチャージします。対応するネットワークにはTRC20上のUSDTとBase上のUSDCが含まれます。最小チャージ額は20ドルから開始します。ボーナスは大口の金額に適用されます。50ドルで5%、100ドルで10%、200ドルで15%の追加ボーナスが得られます。クレジットは期限切れになりません。これは長期的なプロジェクトに理想的です。実際のトークン使用量に対してのみ支払いを行います。エラーと拒否は無料です。これは予期せぬコストから予算を保護します。新規アカウントにはテスト用に0.50ドルが提供されます。標準的な購入に対する返金は行われません。二重請求はサポート経由で修正されます。ウォレットが必要なネットワークをサポートしていることを確認してください。送信前に契約アドレスを確認してください。間違ったネットワークの場合、資金が失われる可能性があります。残高を定期的に確認してください。残高が低いとサービスが予期せず中断される場合があります。可能であればチャージを自動化してください。これにより、重要なタスクの継続的な可用性が確保されます。

コンテンツフィルタと拒否のテスト

モデルがアンセンサードプロンプトで期待どおりに動作することを確認してください。

Uncensoredモデルでも特定のコンテンツタイプに対して制限が適用される場合があります。特定のコンテンツタイプの制限を確認してください。既知のトリガーフレーズでテストしてください。モデルが適切に反応することを確認してください。法的な理由からフィルターを維持しているプロバイダーもいます。モデルを敏感なデータに依存する前にこれらを検証してください。ドメイン内のエッジケースをテストしてください。通常拒否をトリガーするプロンプトを送信します。応答形式を観察します。拒否の理由を返すか、それともコンテンツを静かに生成するか？これらの動作を統合テストに記録してください。これにより本番環境での予期せぬ事態を防ぎます。モデルの動作が変更された場合は、テストを更新してください。チームに大きな変化を通知してください。一貫性はユーザー信頼にとって鍵です。アプリケーションが拒否を適切に処理することを確認してください。すべての応答が有効であると想定しないでください。出力構造を検証してください。ハルシネーションやフォーマットエラーを確認してください。これにより信頼性の高いユーザーエクスペリエンスが確保されます。

無料リクエストのエラーハンドリング実装

スムーズなユーザーエクスペリエンスを維持するためにエラーを適切に処理してください。

ネットワークエラー、タイムアウト、サーバーエラーが発生する可能性があります。指数関数的バックオフによる再試行ロジックを実装してください。一時的なエラーと恒久的なエラーを区別してください。429エラーは一時的なものです。待機して再試行してください。400エラーは恒久的なものです。入力データを確認してください。500エラーはサーバー側です。注意して再試行してください。デバッグのためにすべてのエラーをログに記録してください。リクエストペイロードとレスポンスボディを含めてください。これにより、問題の迅速な再現が可能になります。生のエラーをユーザーに表示しないでください。それらをユーザーフレンドリーなメッセージにフォーマットしてください。ストリーミングエラーは慎重に処理してください。イベントストリームから切断してください。リソースをクリーンアップしてください。アプリケーションがメモリリークしないことを確認してください。エラーシナリオを徹底的にテストしてください。ネットワークの切断をシミュレーションしてください。サーバーのタイムアウトをシミュレーションしてください。リカバリロジックが機能することを確認してください。これにより、悪条件でも信頼性が確保されます。

JSONモードとツール呼び出しでスケールアップ

信頼性の高いデータ抽出と関数実行のために構造化出力を使用します。

設定によりJSONモードを有効にする response_format: {type: "json_object"}これはモデルに有効なJSONを出力させることを強制します。データの解析や設定の生成に使用してください。ツール呼び出しにより、モデルは関数を実行できます。リクエストペイロードでツールを定義します。モデルは呼び出すべきかを判断します。結果をモデルに戻します。モデルは出力に基づいて最終応答を生成できます。これにより複雑なタスクのためのループが作成されます。ツール定義を明確にしてください。曖昧なツールは誤った呼び出しにつながります。解析前にJSON出力を検証してください。これによりコードの実行時エラーを防ぎます。データ抽出タスクにツール呼び出しを使用してください。これにより精度が大幅に向上します。さまざまな入力形式でテストしてください。モデルがエッジケースを処理できることを確認してください。チームのために利用可能なツールを文書化してください。これによりプロジェクト全体で一貫した使用が保証されます。

レビュー プライバシーとデータ使用ポリシー

プロバイダーがデータをどのように保存し、使用するかを理解する。

プライバシーポリシーでデータ保持の詳細を確認してください。一部のプロバイダーはデータをトレーニングに使用します。他のプロバイダーはデータを非公開に保ちます。モデルの改善にデータが使用されないことを確認してください（それが重要である場合）。暗号化基準を確認してください。データは転送中および保管時に暗号化する必要があります。ログが保存されているか確認してください。ログにはプロンプトが含まれる可能性があります。これらのログが安全であることを確認してください。利用規約の責任条項を確認してください。生成されたコンテンツの所有権を理解してください。一部のプロバイダーは出力に対する権利を主張します。これがあなたのニーズと一致していることを確認してください。サービスを使用しなくなった場合はアカウントを削除してください。データが削除されていることを確認してください。懸念がある場合はサポートに連絡してください。監査目的のためにプライバシー設定を記録してください。これにより内部ポリシーへの準拠が保証されます。