エラー契約#
エラーは { error: { message, type, code } } を使用します。無期限に再試行しないでください。
| HTTP | コード | 対処法 |
|---|---|---|
| 400 | invalid_request | JSON、必須フィールド、トークン制限を修正してください。 |
| 401 | invalid_api_key | キーとBearerヘッダーを確認してください。失効した場合はローテーションしてください。 |
| 402 | insufficient_balance | 適格な確認済みチャージ、利用可能クレジット、キー予算を確認してください。新しいチャージはすべて最低100米ドルです。 |
| 403 | model_not_allowed | キーの許可リストを更新するか、許可されたモデルを選択してください。 |
| 404 | model_not_found | /v1/modelsを取得し、正確なIDを使用してください。 |
| 409 | pending_reconciliation | 操作を再試行する前に使用量の調整を待ってください。 |
| 413 | request_too_large | 入力を分割するか、より大きなコンテキストを使用してください。 |
| 422 | unsupported_feature | この機能をサポートするデプロイメントを選択してください。 |
| 429 | quota_exceeded | Retry-Afterが提供されている場合はそれに従い、制限付き再試行を使用してください。公開無料トライアル枠は提供されていません。 |
| 502 | upstream_error | 制限付きバックオフで再試行してください。ステータスを確認してください。 |
| 503 | service_unavailable | 再試行する前にサービス状態とモデルの可用性を確認してください。 |
重複作業を避ける#
接続が切断されたからといって、推論リクエストが無料だったと想定しないでください。使用記録を確認してください。入金はプロバイダーのトランザクションIDによって独立して冪等です。
ヘルプを利用する#
サポートガイドを使用して、失敗した手順を診断し、エラーコード、UTC時刻、モデル、合成再現手順を含むレポートを準備してください。ローカルレポートツールはチケットを送信しません。認証情報と顧客コンテンツをレポートに含めないでください。
リクエスト例
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'