ベースURLについて
ベースURLは、クライアントがリクエストを送信する場所を定義します。ここでの不一致は、即時の接続失敗または予期しないモデル応答を引き起こします。多くの開発者は標準的なOpenAI URLが普遍的に機能すると考えますが、制限なしプロバイダーは通常、特定のモデルプールにトラフィックをルーティングするために独自のエンドポイントを使用します。
設定が以下を指していることを確認してください https://api.openrouterabliteratedmodels.com/v1 当サービス用。サードパーティの集約サービスを使用している場合は、ベースURLがそのドキュメントと完全に一致していることを確認してください。誤ったURLは、404エラーや意図した検閲なしバリアントではなくデフォルトモデルからの応答を引き起こすことがよくあります。
- 環境変数を確認してください。
BASE_URLまたはAPI_HOST. - パスに
/v1標準的な互換性のため。 - 大量の使用前に単純なモデルリストリクエストで接続性をテストします。
レートリミットの処理
レートリミットは、特定の時間枠内で送信できるリクエスト数を制限します。当社のAPIでは、キーごとに1分あたり300リクエストの制限を適用しています。この閾値を超えると、HTTP 429エラーが発生し、ウィンドウがリセットされるまで一時的にリクエストがブロックされます。
さらに、キーあたり同時に8リクエストの同時実行制限があります。8件を超える同時リクエストを送信すると、 excess はキューに入るか、クライアントライブラリに応じて失敗します。これらのハード制限に達しないようアプリケーションの同時実行を監視してください。サーバーにスパムを送りすぎないよう、コードで指数関数的バックオフ戦略を使用して429エラーを適切に処理してください。
各キーはアカウント固有であることを覚えておいてください。複数のサービス間でキーを共有すると、これらの制限に達する速度が加速します。アプリケーションの異なる部分に別のレート制限プールが必要な場合は、新しいキーを生成してください。
ストリーミングと非ストリーミングの応答
ストリーミングはトークンが生成されるたびに逐次データを返し、非ストリーミングは完全なレスポンスを待機します。ストリーミングはリアルタイムのユーザー体験に不可欠ですが、Server-Sent Events (SSE) の注意深い処理が必要です。
ストリーミング時、最終チャンクにはトークン使用量の統計情報が含まれます。処理を早期に停止すると、このデータを見逃す可能性があります。クライアントが最後のSSEメッセージを解析して、入力および出力トークン数を正確に取得するようにしてください。非ストリーミングレスポンスは単純ですが、長い出力では高レイテンシを引き起こす可能性があります。
ユーザーが文字単位でテキストを表示するチャットインターフェースにはストリーミングを選択してください。バッチ処理や、処理を続ける前に完全な応答が必要な場合は非ストリーミングを使用してください。当APIは、 stream リクエストボディのパラメータ。
JSONモードのエラー
JSONモードにより、モデルは有効なJSONのみを出力し、プログラム統合にとって重要です。ここでのエラーは、通常、ヘッダーの誤りやスキーマの不一致に起因します。APIは response_format: {"type": "json_object"} 厳密なJSON出力を強制します。
整形されていないJSONが返された場合は、スキーマ定義を確認してください。モデルはJSON構造の外にマークダウンコードブロックや説明文を含める場合があります。マークダウンフェンスを削除したり、期待されるスキーマに対して出力を検証したりできる堅牢なパーサーを使用してください。モデルを混乱させる過度に複雑なスキーマを避けてください。
まずは単純な構造からテストしてください。モデルがどこでつまずくかを特定するために複雑さを徐々に増やしてください。温度が適切に設定されていることを確認してください。高い温度はランダム性を増し、JSONの妥当性を低下させる可能性があるためです。
トークン数の誤計算
トークン数は請求とコンテキストウィンドウの使用量を決定します。計算ミスは、予期せぬ請求や切り捨てられたレスポンスにつながる可能性があります。当社のAPIは、1Mあたりの入力トークンに対して$0.15、1Mあたりの出力トークンに対して$0.50を請求します。
モデルのトークン化スキームと一致する信頼性の高いトークナイザーライブラリを使用してください。異なるモデルでは空白や句読点のトークン化方法が異なるため、ローカルでのカウントとAPIのカウントに乖離が生じる可能性があります。正確な課金のためには、常にレスポンスで返されるトークン使用量を信頼してください。
コンテキストウィンドウは合計100,000トークンであるため、注意深く監視してください。この制限を超えるとエラーが発生します。古いメッセージや要約を切り捨てて、制限内に収めてください。時間とともにトークン使用量を監視し、プロンプト構造を最適化してコストを削減してください。
暗号通貨決済の遅延
USDT（TRC20）またはUSDC（Base）による暗号通貨チャージは、当社側で即時に処理されます。ただし、ネットワークの混雑により確認に若干の遅れが生じる場合があります。損失を避けるため、正しい金額とネットワークを送信してください。
トップアップは整数金額で$20〜$500の範囲です。ボーナスクレジットは自動的に適用されます：$50で+5%、$100で+10%、$200で+15%。支払いを確認するにはトランザクションハッシュを検証してください。クレジットが数分以内に反映されない場合は、ブロックチェーンエクスプローラでトランザクションステータスを確認してください。
クレジットは期限切れにならないため、急いで使用する必要はありません。二重請求などのミスはサポートページで解決されます。問題が発生した場合に備え、取引記録を保管してください。
モデルID構成
モデルIDは、使用しているuncensoredモデルのバージョンを識別します。当社のサービスでは、モデルIDは uncensored間違ったIDを使用すると、エラーや予期しない動作の原因となることがあります。
リクエストで model: "uncensored" リクエストボディ内。このIDは、制限のないレスポンス用にチューニングされた特定のオープンウェイトモデルを指しています。これは汎用的な識別子ではなく、ホストされたインスタンスへの特定のポインタです。
クライアントライブラリのドキュメントを確認し、モデルIDの設定方法を確認してください。一部のライブラリは、 model フィールド、他の場合は異なるパラメータを使用します。アプリケーション全体でモデルIDの一貫性を保つことで、混乱を防ぎ、常に意図したuncensoredモデルを呼び出していることを確保します。
コンテキストウィンドウの超過
コンテキストウィンドウは、1つのリクエストで送信できるトークンの総数を制限します。当APIは、プロンプトと補合を含む100,000トークンのウィンドをサポートします。この制限を超えるとエラーが発生します。
コンテキストを管理するには、スライディングウィンドウ戦略を実装してください。古いメッセージを削除するか要約してスペースを空けてください。入力のトークン数が100,000トークンの制限内に収まることを確認するためにトークン数を監視してください。制限を超えた場合、APIはリクエストを拒否します。
を使用 max_tokens 出力の長さを制御するパラメータ。1リクエストあたりの最大出力は16,000トークンです。このパラメータを設定することで、トークン使用量の過剰な増加を防ぎ、アプリケーションにとって管理可能な範囲内にレスポンスを維持できます。
サポートと返金ポリシー
使用されたクレジットは返金されませんが、期限切れしません。支払いやサービスに問題が発生した場合は、指定されたページ経由でサポートにご連絡ください。二重請求などのミスはサポートチームによって解決されます。
技術的な問題については、まずドキュメントを確認してください。当社のAPIはシンプルですが、エッジケースが発生する場合があります。ヘルプを求める際には、APIキーとリクエストの詳細を提供してください。応答時間は異なりますが、迅速な解決を目指しています。
クレジットは前払いされることを覚えておいてください。消費した分だけ支払い、エラーや拒否は無料です。このモデルは請求の透明性を保証します。アカウントに関する不整合や質問がある場合は、サポートページをご利用ください。
