Skip to main content
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
Supertone APIは標準的なHTTPステータスコードを使用します。エラーは問題を説明するJSONボディを返し、SDKはそれをキャッチして処理できる型付き例外として公開します。

ステータスコードリファレンス

SDKのエラークラス

両方のSDKは各ステータスコードを型付きエラークラスにマッピングします。文字列を解析するよりも、特定のクラスをキャッチする方がクリーンです。
すべてのSDKエラーは以下を公開します。

各エラーへの対応

4xx — クライアント側

5xx — サーバー側

よくある落とし穴

  • POSTリクエストで**Content-Type: application/jsonが欠落**していると400になります。
  • 先頭/末尾に空白が含まれるAPIキー(コピー&ペースト時によく発生)は401になります。
  • 「IDを知っている」場合でも、別のアカウントからカスタムボイスを呼び出す403になります。
  • 生のAPIに300文字を超えるtextを送信すると400になります。長いテキストを自動チャンク分割するにはSDKを使用してください。

関連項目

リトライとバックオフ

429および5xxに対する適切なリトライポリシー。

レート制限

アカウントティア別の制限。