GEgenaipro
Voice AI Beta — Max

Get Task

Changed on

Task detail, including original content and settings. When status is completed the audio URL is in result.

Rate limit: 120 requests/minute

get/v1/tts/max/{id}

Request

Path parameters

idstring required

Response

Task detail

idstring

Task ID

titlestring

Task title

status'pending' | 'cloning' | 'queued' | 'processing' | 'merging' | 'process_merging' | 'completed' | 'failed'

Voice AI Beta task lifecycle: pending → cloning (clone flow only) → queued → processing → merging → process_merging → completed | failed.

providerstring

Provider: nova, lyra, sirius, vega, max (other values may appear as new providers launch)

resultstring

Audio file URL (empty until completed). Public; deleted about 90 days after creation (then 404) — download it yourself.

total_lengthinteger

Billable characters (encoder units ≈ UTF-8 bytes — see the Voice AI Beta tag)

process_percentageinteger

Progress percentage

errorstring

Failure reason (only when status is failed)

created_atstring date-time
updated_atstring date-time
contentstring

Original input text (SRT tasks — the SRT content)

voice_idstring

Preset voice used (empty when a clone was used)

voice_asset_idstring

Voice clone used (only present on clone tasks)

formatstring
tts_modelstring
languagestring

ISO-639-1 code (empty = automatic detection)

speednumber
volumenumber
pitchinteger
subtitle_availableboolean

Whether POST /v1/tts/max/{id}/export-subtitle can build a subtitle for this task

Example response

{
  "id": "0198c2f1-7b7a-7c11-a3f2-3e9d2b1c4a55",
  "status": "completed",
  "provider": "nova",
  "result": "https://files.genaipro.io/0198c2f1.mp3",
  "total_length": 1234,
  "format": "mp3",
  "tts_model": "max-hd",
  "language": "en"
}

Changes