間違ったbase_urlを使用
標準的なOpenAIベースURLを使用すると、リクエストが失敗するか、別のモデルにルーティングされます。当社のAPIでは、 base_url に https://api.whatisopenrouterai.com/v1この設定の単一行により、SDKがグローバルなOpenAIインフラストラクチャではなく当社のサーバーに接続されます。
多くの開発者は、既存のコードをコピー＆ペーストする際にこの変数を更新しません。デフォルトのURLのままにしておくと、404エラーが発生するか、アンセーザードではないモデルにヒットします。常に接続を確認し、 /v1/models エンドポイント。そこには固有のモデル ID が表示されるはずです。これが、最初の completion リクエストを送信する前にルーティングが正しいことを確認します。
モデルIDの設定を忘れないでください
正しいベースURLを使用していても、モデルIDを省略すると、汎用的または古いモデルがデフォルトで選択されます。必ず明示的に設定してください。 model パラメータを "uncensored" すべてのリクエストに含まれます。これにより、ルーティングレイヤーに、無制限コンテンツ向けにチューニングされた特定のオープンウェイトモデルを提供するよう指示します。
この明示的な指示がない場合、異なるアライメントルールを持つ別のモデルが返される可能性があります。一部のモデルは、デフォルトで法的な成人向けトピックを拒否します。強制的に uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
トークン制限とエラーの無視
100,000トークンのコンテキストウィンドウまたは16,000トークンの出力制限を超えると、リクエストは即座に失敗します。当APIでは1リクエストあたりの最大出力を16,000トークンに制限しています。設定しない場合、 max_tokens, デフォルトは2,048トークンです。これは複雑な推論タスクにはしばしば短すぎます。
エラーや拒否は前払いクレジットを消費しません。ただし、レートリミットに達したり本文サイズ（8 MB）を超えたりした不適切なリクエストは、クォータに対してカウントされます。トークン使用量についてはレスポンスヘッダーを監視してください。コンテキストウィンドウ内に収まるようにプロンプトエンジニアリングを調整してください。これにより、高コストなリトライを防ぎ、スムーズなデータフローを確保します。
前払い請求の誤解
アカウントの残高は月額サブスクリプションではなく、前払いクレジットに紐付いています。入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50を課金します。エラーは無料ですが、正常な完了にはクレジットが消費されます。サービスの利用を維持するには暗号通貨で残高を追加する必要があります。
USDT（TRC20）またはUSDC（Base）でのチャージに対応しています。最小預け入れ額は$20からです。ボーナスは上位ティアで適用されます：$50以上で+5%、$100以上で+10%、$200以上で+15%。クレジットの有効期限はありません。大量バッチを実行する前に残高が正であることを確認してください。ダッシュボードで現在の残高と最近の取引を確認してください。
ストリーミングを標準応答と混同する
SSEによるストリーミングはレスポンスストリームの解析方法を変えます。標準的なレスポンスは単一のJSONオブジェクトを返します。ストリーミングは複数のチャンクを返します。正確なトークン使用量統計を取得するには、最後のチャンルを処理する必要があります。
ストリーミング実装では、最後のチャンクにトークン使用量が含まれます。ストリームを途中で停止した場合、このデータを見逃す可能性があります。クライアントライブラリがSSEを適切にサポートしていることを確認してください。これは、トークンを生成と同時に表示するリアルタイムアプリケーションにおいて重要です。ストリーミングの設定ミスは、不完全なテキストやUI状態の破綻を引き起こす可能性があります。
tool_choice設定エラー
誤り tool_choice 設定は関数呼び出しが意図通りに動作しない原因になる可能性があります。特定のツールを強制するか、モデルに判断を任せることができます。誤設定は、モデルが利用可能な関数を無視する結果をもたらすことがよくあります。
使用 tool_choice モデルがツールを自動的に呼び出すかどうかを制御します。に設定します。 "auto" 柔軟性のため、または厳密な動作のためにツールIDを指定します。関数定義が期待されるスキーマと一致していることを確認してください。これにより、モデルが存在しない関数を呼び出そうとした際のランタイムエラーを回避できます。本番環境へのデプロイ前にツール定義を十分にテストしてください。
json_objectモードの欠落
Without response_format: {"type": "json_object"}、モデルはマークダウンまたはプレーンテキストを出力する可能性があります。これは厳密なJSONを期待するパーサーを壊します。JSONモードを有効にして、一貫性のある解析可能な出力を確保してください。
この機能は、構造化データを必要とするダウンストリームシステムとの統合にとって不可欠です。後処理のオーバーヘッドを大幅に削減します。クライアントコードで常に出力スキーマを検証してください。これにより、モデルの偶発的なハルシネーションに対する堅牢性が確保されます。エンティティの抽出や設定ファイルの生成に使用する場合はこのモードを使用してください。
レート制限の予期せぬ事態
当社のAPIは、キーごとに1分あたり300リクエストをサポートしています。この制限を超えると、429 Too Many Errors応答が返されます。並列リクエストはキーごとに最大8つに制限されています。並列設定を適切に計画してください。
複数のプロセスを実行する場合は、同じキーを共有するか、個別のキーを生成してください。各アカウントには1つのアクティブなキーのみがサポートされます。新しいキーは古いキーを置き換えます。レスポンスのレート制限ヘッダーを監視してください。リトライロジックに指数関数的バックオフを実装してください。これにより、高トラフィック期間中の連鎖的な障害を防ぐことができます。
暗号通貨のチャージ遅延
ブロックチェーン上での暗号通貨トランザクションの確認には時間がかかる場合があります。資金を送信した後、クレジットが即時に表示されないことがあります。正しいネットワークを使用してください：USDTにはTRC20、USDCにはBase。間違ったネットワークに送金すると資金が失われます。
チャージ額は$20〜$500です。正確な金額を送信するか、ネットワーク手数料を考慮してください。ブロックチェーンエクスプローラーでトランザクションハッシュを確認してください。クレジットの遅延がある場合は、トランザクションIDを添えてサポートまでご連絡ください。支払いが直ちに失敗したと想定しないでください。ネットワークの混雑時には忍耐がスムーズな運用の鍵です。
