API リファレンス
エラーコード
TokSpan API が返す可能性のあるすべてのエラーコードの完全なリファレンス。説明とトラブルシューティング手順付きです。
HTTP ステータスコード
| コード | 意味 | 対処方法 |
|---|---|---|
| 200 | 成功 | リクエストが正常に完了しました |
| 400 | 不正なリクエスト | リクエストボディに不正な JSON 形式や必須フィールドの欠落がないか確認してください |
| 401 | 認証エラー | API キーが正しく、ダッシュボードで有効になっているか確認してください |
| 402 | お支払いが必要です | 残高不足です — 課金ダッシュボードでチャージしてください |
| 404 | モデルが見つかりません | モデル ID を確認してください — 利用可能なモデル をご参照ください |
| 429 | レート制限 | 指数バックオフを実装してください — レート制限 をご参照ください |
| 500 | 内部エラー | TokSpan 側の問題です — バックオフ付きで再試行するか、サポートにお問い合わせください |
| 502 | 不正なゲートウェイ | 上流プロバイダーのエラーです — 自動フェイルオーバーが作動する可能性があります |
| 503 | サービス利用不可 | 一時的な過負荷です — Retry-After ヘッダーの値に従って再試行してください |
エラーレスポンス形式
json
{
"error": {
"message": "Invalid API key",
"type": "authentication_error",
"code": "invalid_api_key"
}
}