Errors

The VoiceLab360 API uses standard HTTP status codes. All error responses return a JSON body with a consistent structure.

Error response format

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The voice_id field is required.",
    "status": 400
  }
}

Status codes

HTTP Status	Meaning
`200`	Success
`400`	Bad request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`402`	Insufficient credits
`403`	Forbidden — key revoked or plan restriction
`404`	Resource not found
`422`	Unprocessable — valid format but failed validation
`429`	Rate limit exceeded
`500`	Internal server error
`503`	Service temporarily unavailable

Error codes

Code	Status	Description
`UNAUTHORIZED`	401	No valid API key provided
`FORBIDDEN`	403	Key is valid but access is denied
`INSUFFICIENT_CREDITS`	402	Not enough credits to complete this request
`RATE_LIMIT_EXCEEDED`	429	Too many requests in the current window
`INVALID_REQUEST`	400	Missing or invalid request parameters
`RESOURCE_NOT_FOUND`	404	The requested resource does not exist
`VALIDATION_ERROR`	422	Request format is valid but content failed validation
`SERVICE_UNAVAILABLE`	503	Endpoint is temporarily offline
`INTERNAL_ERROR`	500	Unexpected server error

Retry guidance

Retry 500 and 503 errors with exponential backoff. Do not retry 400, 401, 402, 403, or 422 errors — these require a fix before retrying.

Overview

Authentication

Core Concepts

Speech Engine

Creative Generation

Voice Agents

Studios

Workforce and Licensing

Buyer Verification

Account

Support

Errors

Errors

Error response format

Status codes

Error codes

Retry guidance

​Errors

​Error response format

​Status codes

​Error codes

​Retry guidance

Errors

Error response format

Status codes

Error codes

Retry guidance