SambaCloud API は、API リクエストの成功または失敗を示すために、標準的な HTTP ステータスコードを使用します。 リクエストが失敗した場合、API はエラーの詳細を含む JSON オブジェクトを返します。これには以下の情報が含まれます：
  • エラーコード
    • エラーの種類を識別します。
  • パラメータ (該当する場合)
    • エラーの原因となったプロパティを示します。
  • エラーメッセージ
    • 問題の内容を明確に説明します。

​
エラーメッセージ例

以下のエラーメッセージは、パラメータの値が許容される最大値を超えたことを示しています。top_p パラメータに 100 が指定されましたが、本来の許容範囲は 0 から 1 の間です。エラータイプは invalid_request_error、コードは decimal_above_max_value です。
Example error message
{
  "error": {
    "message": "Decimal above maximum value. Expected a value between 0 and 1, but got 100 instead.",
    "type": "invalid_request_error",
    "param": "top_p",
    "code": "decimal_above_max_value"
  }
}

​
エラーカテゴリ一覧

以下の表は、HTTP ステータスコードごとのエラーカテゴリと対処方法を示しています。
HTTPステータスカテゴリ説明推奨対応
400不正なリクエスト無効な構文やパラメータにより、リクエストを処理できませんでした。API リクエストの構文とパラメータを見直してください。
401認証エラー認証情報が存在しないか無効です。有効な API キー/トークンが含まれているか確認してください。
408リクエストタイムアウトサーバーが処理時間超過によりリクエストを終了しました。ペイロードを最適化して再試行してください。
410利用不可指定されたモデルは提供終了または削除され、利用できません。現在サポートされているモデルを使用してください。
429リクエスト過多ご利用中のサブスクリプションティアのレート制限を超過しました。ご自身のアプリケーション内でリクエストの頻度を制御 (レート制限)するか、プランのアップグレードを検討してください。
500サーバーエラーサーバー側で予期しないエラーが発生しました。後ほど再試行してください。エラーが継続する場合はサポートへご連絡ください。
503メンテナンス中メンテナンスのため、モデルが一時的に利用できません。しばらく時間をおいてから再試行してください。
504キュー満了リクエストが多数処理中のため拒否されました。少し時間をおいてから再試行するか、同時リクエスト数を減らしてください。

​
エラーコードリファレンス

以下の表に従って、プログラム上でエラーを識別し、トラブルシューティングを実施してください。
HTTPステータスエラーコード説明推奨対応
400context_length_exceeded入出力のトークン数がモデルのコンテキスト上限を超えました。プロンプトと応答の長さを短くし、モデルの制限内に収めてください。
invalid_typeパラメータの型が不正です。 (例: 整数が期待されるところに浮動小数点を入力)パラメータの型を確認し、適切な形式で入力してください。
decimal_above_max_value少数値が許容最大値を超えています。許容範囲内の値に調整してください。
decimal_below_min_value少数値が許容最小値を下回っています。許容最小値以上の値を指定してください。
integer_above_max_value整数値が許容最大値を超えています。有効な範囲内のより小さい整数を指定してください。
model_not_found指定されたモデル ID が存在しません。モデル ID を確認し、現在のご契約プランで使用可能なものかご確認ください。
401invalid_authenticationAPI キーが無効または期限切れです。SambaCloud ポータルから有効な API キーを取得・設定してください。
408request_timeoutサーバー負荷やレイテンシによりタイムアウトしました。リクエストペイロードを軽くして再試行、または上位プランへの変更を検討してください。
410model_deprecated指定されたモデルは提供終了し、利用できません。ドキュメントに記載された対応モデルをご使用ください。
429insufficient_quotaクォータを超過しています。上位プランへのアップグレードをご検討ください。
500internal_server_errorサーバー内部で予期しないエラーが発生しました。後ほど再試行してください。問題が続く場合はサポートへご連絡ください。
503maintenanceモデルがメンテナンス中のため一時的に利用できません。しばらく時間をおいて再試行するか、メンテナンス情報を確認してください。
504queue_full同時処理中のリクエストが多すぎてサーバーがリクエストを拒否しました。時間をあけて再試行するか、リクエストの頻度を減らしてください。