API 平台

旧接口迁移

如果你已经接入旧 /api/v1 任务模型,需要迁移到当前 /v1 音频接口。两者不是同一套契约。

路径迁移

能力旧路径新路径
单人语音生成POST /api/v1/ttsPOST /v1/audio/speech
多人语音生成POST /api/v1/ttsdPOST /v1/audio/speech/speakers
音频转写POST /api/v1/transcriptionsPOST /v1/audio/transcriptions
任务查询GET /api/v1/tasks/{client_task_id}GET /v1/audio/tasks/{task_id}
文件上传POST /api/v1/files/uploadPOST /v1/files
创建音色POST /api/v1/voice/clonePOST /v1/audio/voices

字段迁移

旧字段新字段 / 新行为
model_id / model_versionmodel
client_task_id由服务端返回 task_id
callback_urlwebhook_url
voice_url / voice_data先创建 voice_id,再在 TTS 中使用 voicevoice_id
audio_data不支持;ASR 使用 file / file_id / url / audio_url
response_format 禁用现在支持 response_format,默认 mp3