API Platform

Legacy Endpoint Migration

If you have already integrated the legacy /api/v1 task model, you need to migrate to the current /v1 audio endpoints. The two are not the same contract.

Path migration

CapabilityLegacy pathNew path
Single-speaker speech generationPOST /api/v1/ttsPOST /v1/audio/speech
Multi-speaker speech generationPOST /api/v1/ttsdPOST /v1/audio/speech/speakers
Audio transcriptionPOST /api/v1/transcriptionsPOST /v1/audio/transcriptions
Task queryGET /api/v1/tasks/{client_task_id}GET /v1/audio/tasks/{task_id}
File uploadPOST /api/v1/files/uploadPOST /v1/files
Create a voicePOST /api/v1/voice/clonePOST /v1/audio/voices

Field migration

Legacy fieldNew field / new behavior
model_id / model_versionmodel
client_task_idtask_id returned by the server
callback_urlwebhook_url
voice_url / voice_dataCreate a voice_id first, then use voice or voice_id in TTS
audio_dataNot supported; ASR uses file / file_id / url / audio_url
response_format disabledresponse_format is now supported, defaulting to mp3