创建语音克隆任务

启动一个语音克隆任务。您可以直接上传音频文件，也可以提供现有音频文件的 URL。

请求信息

方法: POST
端点: /api/instant/create-task
内容类型: multipart/form-data

请求参数

参数	类型	必需	描述
`audio`	文件 (二进制)	是*	用于语音克隆的音频文件。支持的格式包括 WAV、MP3 和 M4A。您必须提供 `audio` 或 `audio_url` 之一。
`audio_url`	string	是*	用于语音克隆的公开可访问的音频文件 URL (WAV, MP3, M4A)。您必须提供 `audio` 或 `audio_url` 之一。
`text`	string	是	您希望以克隆语音合成的文本。
`api_key`	string	是	您的唯一 API 密钥，用于认证和访问。此密钥用于验证您的请求并将其链接到您的用户帐户。
`voice_id`	string	否	可选的语音ID参数

*注意：audio 和 audio_url 参数二选一，至少提供其中一个。

响应

成功响应


{
  "task_id": "1406bf34-735c-4b21-98ac-a135b2afb1c8",
  "status": "pending"
}

错误响应

400 Bad Request: 缺少必需参数（例如 api_key，或 audio/audio_url 均未提供）

示例请求

使用音频文件


curl -X POST https://aivoiceclonefree.com/api/instant/create-task \
  -F "[email protected]" \
  -F "text=这是一段很长的文本，适合使用异步接口处理..." \
  -F "api_key=your_api_key_here"

使用音频URL


curl -X POST https://aivoiceclonefree.com/api/instant/create-task \
  -F "audio_url=https://example.com/sample.mp3" \
  -F "text=这是一段很长的文本，适合使用异步接口处理..." \
  -F "api_key=your_api_key_here"

任务状态说明

创建任务后，您会收到一个 task_id 和初始状态 pending。可能的状态值：

状态	描述
`pending`	任务已提交，等待处理
`processing`	任务正在处理中
`completed`	任务已完成
`failed`	任务处理失败

下一步

任务创建成功后：

保存返回的 task_id
使用任务状态查询监控进度
任务完成后通过获取任务结果下载音频

最佳实践

文本长度: 建议单次任务文本长度不超过10000字符
音频质量: 使用高质量的音频样本可以获得更好的克隆效果
API限制: 注意API调用频率限制，避免过于频繁的请求