创建声音克隆任务

POST

/v1/tasks/voice-clone

从音频样本克隆声音，获取自定义 voice_id，可用于后续 TTS 任务。

必填参数：

audio_file_id — 音频文件 ID（支持 mp3/wav/m4a，10-300 秒，≤20MB）

可选参数：

voice_name — 克隆声音的名称

clone_model — 克隆模型，目前仅支持 3（Pro）

计费： 固定 210 积分/次

注意： 这是同步任务，请求返回后即包含 voice_id

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Header 参数

Body 参数application/json必填

示例

{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "clone_model": 3,
    "audio_file_id": "string",
    "voice_name": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/tasks/voice-clone' \
--header 'x-code;' \
--header 'app-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "clone_model": 3,
    "audio_file_id": "string",
    "voice_name": "string"
}'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "task_id": "string",
        "status": 0,
        "estimated_points": 0,
        "message": "Task created",
        "voice_id": "string"
    }
}

🟠422Parameter Error

修改于 2026-07-10 07:58:13

创建字幕同步任务

创建爆款学习任务