语音TTS · 克隆音色

上传参考音频或提供音频URL,创建专属语音音色模型

<details>
<summary>基本信息</summary>

字段内容
类型应用 API
应用名称语音TTS
应用编码voice_tts
API 名称克隆音色
API 编码clone_voice
请求方式POST
请求路径/api/v1/apps/voice_tts/clone_voice
调用模式同步

</details>

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

POST /api/v1/apps/voice_tts/clone_voice

业务参数

参数类型必填默认值可选值 / 范围示例说明
tagsarray否———模型标签数组
textsarray否———与音频对应的文本数组;不传时自动ASR
titlestring是———音色名称
audio_urlstring否—mp3 / wav / ogg / flac—参考音频URL(与上传文件二选一),支持 mp3/wav/ogg/flac
visibilitystring否—public / unlist / private—可见性:public / unlist / private,平台默认 private
descriptionstring否———音色描述
enhance_audio_qualityboolean否———是否增强音频质量,默认 false

请求示例

{
    "tags": [],
    "texts": [],
    "title": "string",
    "audio_url": "mp3",
    "visibility": "private",
    "description": "string",
    "enhance_audio_quality": true
}

成功响应

{
    "code": 1,
    "msg": "success",
    "data": {
        "_comment": "具体字段以接口实际返回为准"
    }
}

失败响应

{
    "error": {
        "message": "点数余额不足",
        "type": "insufficient_points",
        "code": "insufficient_points"
    }
}

错误码

HTTPcode含义
400invalid_request参数缺失或格式错误
401auth_failedAPI Key 缺失或无效
402insufficient_points点数余额不足
402key_quota_exceeded当前 API Key 点数额度不足
403permission_denied当前 API Key 无权调用该模型/应用
404not_found模型 / 应用 / 任务不存在
429queue_limit_exceeded排队任务已达上限
5xxserver_error服务异常,请稍后重试

同类文章