メインコンテンツへスキップ
Cartesia-Version: 2026-03-01 以降では、Cartesia は構造化された JSON エラーオブジェクトを返します。 それより古い API バージョンでは、エラーがプレーンテキスト（例: Title: Message）になる場合があります。

​
HTTP エラーオブジェクト

HTTP error response
{
  "error_code": "concurrency_limited",
  "title": "Too many concurrent requests",
  "message": "You have exceeded your plan's concurrency limit.",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}
フィールド型必須Null 可備考
error_codestringはいはいマシン可読なコード。該当するコードがない場合は null になります。
titlestringはいいいえ短い人間可読のエラー要約。
messagestringはいいいえ詳細な人間可読のエラー説明。
request_idstring (UUID)はいいいえサポート／デバッグ用のリクエスト識別子。
doc_urlstringいいえいいえエラーに関するドキュメントへのオプションのリンク。利用できない場合は省略されます。

​
WebSocket エラーイベントオブジェクト

WebSocket error event
{
  "type": "error",
  "done": true,
  "status_code": 429,
  "error_code": "concurrency_limited",
  "title": "Too many concurrent requests",
  "message": "You have exceeded your plan's concurrency limit.",
  "request_id": "550e8400-e29b-41d4-a716-446655440000:happy-monkeys-fly:8a0f5f3a-3b2f-4f28-b73e-8c5f27e2f8bb",
  "context_id": "happy-monkeys-fly"
}
フィールド型必須Null 可備考
typestringはいいいえ常に "error"。
donebooleanはいいいえエラーイベントでは現在常に true。
status_codeintegerはいいいえエラーに対する HTTP ライクなステータスコード。
error_codestringはいはいマシン可読なコード。null の場合があります。
titlestringはいいいえ短い人間可読のエラー要約。
messagestringはいいいえ詳細な人間可読のエラー説明。
request_idstringはいいいえサポート／デバッグ用のリクエスト識別子。WebSocket では UUID またはメッセージごとの派生 ID 文字列の場合があります。
doc_urlstringいいえいいえエラーに関するドキュメントへのオプションのリンク。利用できない場合は省略されます。
context_idstringいいえいいえTTS コンテキスト識別子。利用可能な場合に存在します。

​
SSE エラーイベントオブジェクト

SSE エラーは event: error と data: 行内の JSON で送信されます。
SSE error event
event: error
data: {"type":"error","done":true,"status_code":500,"error_code":null,"title":"Unexpected error","message":"An unexpected error occurred, please contact support@cartesia.ai if the problem persists.","request_id":"550e8400-e29b-41d4-a716-446655440000"}
フィールド型必須Null 可備考
typestringはいいいえ常に "error"。
donebooleanはいいいえエラーイベントでは現在常に true。
status_codeintegerはいいいえエラーに対する HTTP ライクなステータスコード。
error_codestringはいはいマシン可読なコード。null の場合があります。
titlestringはいいいえ短い人間可読のエラー要約。
messagestringはいいいえ詳細な人間可読のエラー説明。
request_idstring (UUID)はいいいえサポート／デバッグ用のリクエスト識別子。
doc_urlstringいいえいいえエラーに関するドキュメントへのオプションのリンク。利用できない場合は省略されます。

​
現在のエラーコード

将来、より多くのエラーコードが追加される可能性があります。インテグレーションは未知の error_code 値を適切に処理する必要があります。
error_code意味
quota_exceededアカウントがクォータ（クレジットやエージェント使用量など）を超過しました。
concurrency_limitedアカウントがプランの同時実行制限を超過しました。
voice_model_mismatch要求されたボイスが、要求されたモデルと互換性がありません。
voice_not_found要求されたボイスが存在しません。
model_not_found要求されたモデルが存在しません。
language_not_supported要求された言語が、要求されたモデルまたはボイスでサポートされていません。
file_too_largeアップロードされたファイルが大きすぎます。
unsupported_audio_format指定された音声フォーマットはサポートされていません。
plan_upgrade_requiredこの機能には上位プランが必要です。