旧接口迁移
如果你已经接入旧 /api/v1 任务模型,需要迁移到当前 /v1 音频接口。两者不是同一套契约。
路径迁移
| 能力 | 旧路径 | 新路径 |
|---|
| 单人语音生成 | POST /api/v1/tts | POST /v1/audio/speech |
| 多人语音生成 | POST /api/v1/ttsd | POST /v1/audio/speech/speakers |
| 音频转写 | POST /api/v1/transcriptions | POST /v1/audio/transcriptions |
| 任务查询 | GET /api/v1/tasks/{client_task_id} | GET /v1/audio/tasks/{task_id} |
| 文件上传 | POST /api/v1/files/upload | POST /v1/files |
| 创建音色 | POST /api/v1/voice/clone | POST /v1/audio/voices |
字段迁移
| 旧字段 | 新字段 / 新行为 |
|---|
model_id / model_version | model |
client_task_id | 由服务端返回 task_id |
callback_url | webhook_url |
voice_url / voice_data | 先创建 voice_id,再在 TTS 中使用 voice 或 voice_id |
audio_data | 不支持;ASR 使用 file / file_id / url / audio_url |
response_format 禁用 | 现在支持 response_format,默认 mp3 |