Audio & music - MaxAPI Developer

Audio APIs may return a synchronous binary stream or an asynchronous music task. Check the documented response media type before parsing the body.

Endpoint categories

Use case	Common endpoint	Response
Speech to text	`POST /v1/audio/transcriptions`, `POST /fish/v1/asr`	JSON text and timestamp segments
Audio translation	`POST /v1/audio/translations`	JSON text
Text to speech	`POST /v1/audio/speech`, `POST /fish/v1/tts`	Binary audio stream
Sound effects and lip sync	`/ent/v2/text2audio`, `/ent/v2/lip-sync`	Asynchronous task
Music and lyrics	`/suno/*`	Task ID, track, or lyric data

A TTS response is not JSON. Save the body as MP3, WAV, PCM, or Opus according to the Content-Type header and requested output format.

Music tasks

Suno API families expose separate submission, upload, lyric generation, and status endpoints. Create and retrieve a job with endpoints from the same version and path family.

Handle asynchronous tasks

Add polling, timeout, and retry handling for music and audio jobs.