まず、失敗したステップを特定する
サービスステータスを確認し、アカウントアクセス、API認証、モデル検出、推論、支払いの問題を分離してください。カタログにモデルが表示されていても、ライブ可用性を確立するものではありません。GET /v1/modelsに接続済みデプロイメントが一覧表示されます。
503 service_unavailableは、必要なサービスがリクエストを受け付けられないことを意味します。再試行する前にサービスステータスとAPIリファレンスを確認してください。繰り返しリクエストしても利用できないサービスを有効にすることはできません。専用GPUの場合は、プロビジョニングの確認を待ってください。支払いについては、注文の指示と記録された検証ステータスに従ってください。注文を更新してもクレジットは追加されません。
推測ではなくレスポンスから判断する
HTTPステータスとエラーの code と message を記録します。アプリケーションロジックを変更する前に、設定されたAPIベースURL、正確なモデルID、クライアントバージョンを確認してください。
- 401: Bearerヘッダーと、キーが失効していないかを確認します。完全なキーはログに残さないでください。
- 403: キーの許可リストで許可されているモデルを選択してください。
- 400または413: JSON、必須フィールド、出力上限、入力と出力を合算したコンテキスト予算を確認してください。
- 402: アカウントに、少なくとも100米ドルの適格な確認済み入金があるか確認し、その後利用可能なクレジットと選択したキーの予算を確認してください。適格アカウントは100米ドルの残高を維持する必要はありません。
- 429: Retry-Afterヘッダーが提供されている場合はそれに従い、回数を制限した再試行を行い、該当するサービス制限を確認してください。1日ごとの無料トライアル枠はありません。
- 502または503: 回数を制限した再試行の前に、可用性とエラーメッセージを確認してください。
エラーガイドと制限で回復方法を説明しています。新しいリクエストは新たな処理を生む可能性があります。クライアントの再試行が重複除去されるとは想定しないでください。
中断されたストリームと保留中のクレジットを一緒に扱う
ブラウザタブのクローズ、タイムアウト、ストリームの破損は、生成が停止したことを証明しません。応答識別子と受信した場合は最終使用フレームを保存してください。最終使用フレームは選択のfinish_reason後に到着する場合があります。ネットワークチャンクは必ずしも完全なイベントではありません。
409 pending_reconciliation、またはディスパッチ後の上流エラーは、正式な使用量が利用可能になるまでクレジットを予約したままにする可能性があります。保留を解除するために重複リクエストを送信しないでください。UTC時刻、モデル、キー名をコンソールの使用量と比較し、照合のためにリクエスト詳細を保持してください。クリア時間は保証されません。
支払いの問題については、注文参照、アセット、ネットワーク、金額、表示ステータスを記録してください。最初の支払いが保留中であるという理由だけで別の支払いを送信しないでください。ウォレット引き出しは現在利用できません。アクティベーション前に有料GPU注文をキャンセルすると、その支払いはWeightsAPIアカウント残高に返金されます。ウォレットに資金を転送するものではありません。
再現可能な証拠を準備する
有用なレポートには、操作、UTCタイムスタンプ、エンドポイントパス、モデルID、SDKまたは統合とそのバージョン、ストリーミング設定、出力トークン上限、ステータス/エラー、期待される結果、実際の結果が含まれます。利用可能な場合のみ、レスポンスまたはトランザクション参照を含めてください。現在、ゲートウェイはすべてのエラーでサポートIDを公開していません。
問題を再現する最小の合成例を追加してください。実際の会話、顧客記録、私的文書は架空のテキストに置き換えてください。関連する再試行回数と、問題がリクエスト間で再発するかどうかを含めてください。スクリーンショットでは、共有するつもりのない認証情報、残高、識別子を削除した上で、エラーとコンテキストを示す必要があります。
専用GPUのご注文については、注文参照番号、構成、および支払いまたはプロビジョニングの状況を明記してください。保留中の注文は稼働中のマシンではありません。
認証情報と顧客コンテンツを除外する
APIシークレット、Authorizationヘッダー、セッションCookie、秘密ウォレットキー、リカバリーフレーズ、完全な環境ファイルを決して含めないでください。キー名または意図的に短縮されたプレフィックスで、アプリケーションを区別するには十分です。公開トランザクション参照は依然としてアクティビティとウォレットを結び付ける可能性があります。調査に必要なものだけを共有してください。
キーが漏洩した場合は、交換用キーを作成し、アプリケーションを更新し、古いキーを失効させてください。失効は新規の受け入れをブロックしますが、以前に受け入れられたリクエストは通常どおり処理されます。キーの取り扱いについては認証を参照してください。
レポートを保存し、連絡先詳細を確認する
レポートをコピーして確認し、関連するリクエストまたは注文参照とともに保管してください。コピーしてもチケットは送信されません。公式サポート連絡先とサービス時間は公開されていません。レポートを共有するには確認済みのチャネルのみを使用してください。
応答目標、エスカレーション連絡先、サービス控除は確立されていません。資格情報や機密の顧客コンテンツをレポートに含めないでください。