エラーコード - Runbase Docs

既知の API エラーは、次の構造を持つ JSON 本文を返します:

{
  "error": {
    "message": "Human-readable description",
    "code": "error_code"
  }
}

エラーリファレンス

400 Bad Request

Code	Cause	Fix
`invalid_json`	リクエスト本文が有効な JSON ではありません	JSON の構文を確認してください
`missing_model`	`model` フィールドがない、または文字列ではありません	リクエスト本文に `"model": "provider/name"` を含めてください
`missing_input`	`input` フィールドがない、またはオブジェクトではありません	リクエスト本文に `"input": {...}` を含めてください
`invalid_input`	入力がモデルのスキーマと一致しません	必須フィールドと有効な値について、モデルの API リファレンスを確認してください
`model_not_found`	モデル ID が利用可能なモデルのどれにも一致しません	有効なモデル ID については models page を参照してください

401 Unauthorized

Code	Cause	Fix
`missing_api_key`	`Authorization` ヘッダーがない、または形式が正しくありません	リクエストに `Authorization: Bearer sk-...` を含めてください
`invalid_api_key`	キーが無効、無効化済み、または期限切れです	新しいキーを作成するか、Settings → API Keys で既存のキーを再有効化してください

402 Payment Required

Code	Cause	Fix
`insufficient_balance`	この実行には残高が不足しています	Settings → Credits で残高をチャージしてください

403 Forbidden

Code	Cause	Fix
`api_key_spend_limit_exceeded`	キーの生涯支出上限に達しました	Settings → API Keys で支出上限を引き上げてください
`ip_not_allowed`	あなたの IP がキーのホワイトリストに含まれていません	あなたの IP をキーの許可リストに追加するか、ホワイトリストを削除してください

429 Too Many Requests

Code	Cause	Fix
`RATE_LIMITED`	短時間にリクエストが多すぎます	待ってから再試行してください。詳細は rate limits を参照してください
`USAGE_EXCEEDED`	キーの使用クォータが使い切られています	サポートに連絡するか、新しいキーを作成してください

404 Not Found

Code	Cause	Fix
`run_not_found`	あなたのアカウントにこの ID の run はありません	run ID が正しいこと、およびこの API キーで作成されたものであることを確認してください

500 Internal Server Error

こちら側で予期しないエラーが発生しました。これが続く場合は、support@runbase.net に連絡してください。

コードでのエラー処理

response=$(curl -s -w "\n%{http_code}" https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/nano-banana-2", "input": {"prompt": "test"}}')
 
http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | head -1)
 
if [ "$http_code" -ne 201 ]; then
  echo "Error $http_code: $(echo $body | jq -r '.error.message')"
fi

429 エラーでは、指数バックオフを実装してください — 再試行前に 1 秒、次に 2 秒、その次に 4 秒待ちます。