创建新的语音角色

POST

https://v1.vocu.ai/api/tts/voice

语音角色

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

name

string

角色名称

必需

prompt

string

必需

角色默认风格音频样本，dataurl格式，如 data:audio/wav;base64,<base64 编码的音频数据>

modelVersion

enum<string>

可选

选择要创建的模型版本(不传默认为v2.0)

枚举值:

v2.0v1.0

默认值:

v2.0

description

string

角色描述

可选

avatar

string

可选

角色头像，dataurl格式，如 data:image/png;base64,<base64 编码的图像数据>

enhance

boolean

可选

是否启用音频预处理（默认为true）

默认值:

true

lora

string

可选

专业克隆样本Zip文件的分片上传ID，若传入则将创建为专业克隆角色；请先通过分片上传接口完成文件上传

示例

{
    "name": "宦伟",
    "prompt": "data:audio/wav;base64,tpjNbeTKpxXh1md3KTHnzOzJrqU7Wfh55IpoUdWBry0WeQ3NfWCvKtrP7W1HZkBgX2hyoyrG5VFGfFho660B6dewFmskNRhURfgBsdIFVwIQfRv7GWGfbOElPGoOlLPwD24BMnfrYuo6ttT43LHdkbI2oteg2p7HVI4a6CGXNuwiKGz2wAGqvUGWLd4etPerSlyZAnyEBjae9zUl0NmKMs2OsChVWSVXU1PRCojKczpTuT0BgRdiaifCOKebnfEreYooba7MdqP0gbppfz6Xaz4tEuTJ1p7iKI7VDzn0ERWWCsGaOCsjGsidHgs6RVcXCKdVDB8CTenn2KyaL1aBv2WeASeOFMF5jgOw5mcHgmVA87eDQUaAHepsfHvR5OrlbkmGB306wR08wlxxI6IMHXKo74BHZDQSretnxRFxcD37ExfXAzUQ5e7o15WCdXe5hay5RIU7Dsp9wfHiV6TT5SxiT0ap4ta3fSegZXG5rlmKfJhJieUP",
    "modelVersion": "v2.1",
    "description": "一个非常厉害的教练",
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIyMjQ3IiBoZWlnaHQ9IjMwNTUiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNhMWUzYjUiLz48dGV4dCB4PSIxMTIzLjUiIHk9IjE1MjcuNSIgZm9udC1zaXplPSIyMCIgYWxpZ25tZW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZpbGw9IndoaXRlIj4yMjQ3eDMwNTU8L3RleHQ+PC9zdmc+",
    "enhance": false,
    "lora": "de4bcda7-5b65-4747-b74a-d03429457fe6"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/tts/voice' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "宦伟",
    "prompt": "data:audio/wav;base64,tpjNbeTKpxXh1md3KTHnzOzJrqU7Wfh55IpoUdWBry0WeQ3NfWCvKtrP7W1HZkBgX2hyoyrG5VFGfFho660B6dewFmskNRhURfgBsdIFVwIQfRv7GWGfbOElPGoOlLPwD24BMnfrYuo6ttT43LHdkbI2oteg2p7HVI4a6CGXNuwiKGz2wAGqvUGWLd4etPerSlyZAnyEBjae9zUl0NmKMs2OsChVWSVXU1PRCojKczpTuT0BgRdiaifCOKebnfEreYooba7MdqP0gbppfz6Xaz4tEuTJ1p7iKI7VDzn0ERWWCsGaOCsjGsidHgs6RVcXCKdVDB8CTenn2KyaL1aBv2WeASeOFMF5jgOw5mcHgmVA87eDQUaAHepsfHvR5OrlbkmGB306wR08wlxxI6IMHXKo74BHZDQSretnxRFxcD37ExfXAzUQ5e7o15WCdXe5hay5RIU7Dsp9wfHiV6TT5SxiT0ap4ta3fSegZXG5rlmKfJhJieUP",
    "modelVersion": "v2.1",
    "description": "一个非常厉害的教练",
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIyMjQ3IiBoZWlnaHQ9IjMwNTUiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNhMWUzYjUiLz48dGV4dCB4PSIxMTIzLjUiIHk9IjE1MjcuNSIgZm9udC1zaXplPSIyMCIgYWxpZ25tZW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZpbGw9IndoaXRlIj4yMjQ3eDMwNTU8L3RleHQ+PC9zdmc+",
    "enhance": false,
    "lora": "de4bcda7-5b65-4747-b74a-d03429457fe6"
}'

返回响应

🟢200成功创建语音角色

application/json

Body

status

enum<integer>

状态码

必需

示例值:

200

固定值:

200

message

string

状态信息

必需

示例值:

data

object (语音角色)

创建的语音角色详情

必需

string

语音角色 ID

必需

idForGenerate

string

可选

如有请在请求语音生成接口时使用该id

name

string

语音角色名称

必需

status

enum<string>

必需

语音角色状态，可以为pending（瞬时克隆已完成）、lora-pending（专业克隆训练中）、lora-success（专业克隆已完成）、lora-failed（专业克隆失败）

枚举值:

pendinglora-pendinglora-successlora-failed

metadata

object

语音角色元数据

必需

示例

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "e4296465-a999-4869-b103-09dc4506bdf1",
        "idForGenerate": "894b9cf3-d0dc-41c9-91dc-2b4947f588d6",
        "name": "宦伟",
        "status": "pending",
        "metadata": {
            "avatar": "https://loremflickr.com/1688/727?lock=1030955216131236",
            "description": "一个非常厉害的教练",
            "prompts": [
                {
                    "id": "default",
                    "name": "默认风格",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/062326/734689-playback-kg1wvu.mp3"
                }
            ]
        }
    }
}

🟠400请求参数错误

🟠403没有权限执行该操作

🔴500服务器内部错误

修改于 2025-02-27 11:50:01

毫秒级低延迟WebSocket实时生成

为指定 ID 的语音角色添加风格