控制台

音色生成

POST/v1/audio/voice/generations

通过文本和声音描述生成音色或语音。

请求参数

字段类型必填说明
model: string必填

模型 ID。推荐使用稳定 model ID;需要复现固定版本时,可填写 snapshot model ID。

input: string必填

要生成语音的文本。

instruction: string必填

声音风格、年龄、情绪、语速等描述。

response_format: string可选

同步请求的音频格式;异步任务实际格式以任务查询返回为准。

delivery_method: string可选

结果交付方式。

create_voice: boolean可选

仅当 delivery_method=url 时可设为 true;创建成功后在 JSON 结果中返回 voice_id,可用于后续 TTS 或 TTSD。不传或设为 false 时仅生成语音预览。

async: boolean可选

设为 true 时创建异步任务并立即返回任务对象。

webhook_url: string可选

异步任务完成后回调的 HTTPS URL。

返回值

接口返回根据声音描述生成的语音预览。同步请求可直接返回音频,或通过 delivery_method=url 获取音频地址;传入 async=true 时返回任务 ID,后续通过查询任务接口获取结果。