エラーコード

APIエラー応答の理解

エラーレスポンス形式
すべてのエラー応答は次の形式に従います:
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
エラーコード
400Bad Request

リクエストパラメータが無効または不正な形式です。

ソリューション: リクエストボディを確認し、必須項目がすべて有効な値で入力されていることを確認してください。

401Unauthorized

APIキーが無効または不足しています。

ソリューション: 有効なAPIキーをAuthorizationヘッダーに含めていることを確認してください。

402Payment Required

APIウォレットのクレジットが不足しています。

ソリューション: クレジットを追加購入するか、クレジットが補充されるまでお待ちください。

403Forbidden

APIへのアクセスが承認されていないか、アカウントが停止されています。

ソリューション: エラーと思われる場合はサポートまでご連絡ください。

404Not Found

要求されたリソース(タスク、Webhookなど)が見つかりませんでした。

ソリューション: リソースIDが正しいことを確認してください。

429Too Many Requests

短時間にリクエストが集中しています。

ソリューション: 指数バックオフを実装し、レート制限を遵守してください。

500Internal Server Error

当方で問題が発生しました。

ソリューション: 短い遅延後にリクエストを再試行してください。問題が解決しない場合は、サポートにお問い合わせください。

レート制限
デフォルトのレート制限:
指標制限
リクエスト毎分60
1日あたりのリクエスト数10,000
並行タスク5
Nano Banana Pro API