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

POST

https://v1.vocu.ai/api/tts/voice/{id}/prompt

语音角色

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

string

语音角色 ID

必需

Body 参数application/json

name

string

风格名称

必需

prompt

string

必需

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

description

string

风格描述

可选

enhance

boolean

可选

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

默认值:

true

示例

{
    "name": "高兴",
    "prompt": "data:audio/wav;base64,fMRLm9LywDeweSOsz0q9zahvHoMrnLvoUTippGeXDe33z0S8hs5tpRcTG3MY8QwG2N8aqVUiYNACiFJOa8OVI7n7JXdAN694A4XyAVQCu4GUjy6z0d3SiWmdolGKcKTQJ0V4PK25bgp9Jyp5uNAJDGZCHxErLo5fiTKffWmuDI3hboQUfbP3kRKQl746HMcemZrMoGeyWbtc8XBujLquIFGm9ZPsNWQNIIM1k9VuwJ5vIIYpg8lPjpikAHhPr5f3MVaS5U3XgbLlHk04zmokryHpvU54xs4asiHcRM0gaKHyM03HlxaH3nkN6FY39rJeTZtS5DZ1Tgn1jK3F8zVKFFOAx8wavYFuEiriRZO4IqwN5v7mNVqgJgYyH9TgcNnUmRP4WRwjcpWHZAZ1NPBB629y1XIt3ScxB16g4bdMOahsWQg1qJ6c9wJElSAzsiq6Z75gAR0f5Z1IvpqSSgBxMcMyVc5QgFHd3F5ldsZ2ExXNvlPZdqgm",
    "description": "高兴的情感风格",
    "enhance": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/tts/voice//prompt' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "高兴",
    "prompt": "data:audio/wav;base64,fMRLm9LywDeweSOsz0q9zahvHoMrnLvoUTippGeXDe33z0S8hs5tpRcTG3MY8QwG2N8aqVUiYNACiFJOa8OVI7n7JXdAN694A4XyAVQCu4GUjy6z0d3SiWmdolGKcKTQJ0V4PK25bgp9Jyp5uNAJDGZCHxErLo5fiTKffWmuDI3hboQUfbP3kRKQl746HMcemZrMoGeyWbtc8XBujLquIFGm9ZPsNWQNIIM1k9VuwJ5vIIYpg8lPjpikAHhPr5f3MVaS5U3XgbLlHk04zmokryHpvU54xs4asiHcRM0gaKHyM03HlxaH3nkN6FY39rJeTZtS5DZ1Tgn1jK3F8zVKFFOAx8wavYFuEiriRZO4IqwN5v7mNVqgJgYyH9TgcNnUmRP4WRwjcpWHZAZ1NPBB629y1XIt3ScxB16g4bdMOahsWQg1qJ6c9wJElSAzsiq6Z75gAR0f5Z1IvpqSSgBxMcMyVc5QgFHd3F5ldsZ2ExXNvlPZdqgm",
    "description": "高兴的情感风格",
    "enhance": false
}'

返回响应

🟢200成功添加角色风格

application/json

Body

status

integer

状态码

必需

示例值:

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": "22454287-ecbd-499c-9ccb-c60f2d38acc7",
        "idForGenerate": "3192abc5-9ab0-4235-be44-eb8a336338b9",
        "name": "潜丽芳",
        "status": "lora-pending",
        "metadata": {
            "avatar": "https://loremflickr.com/2252/1664?lock=6544168410253842",
            "description": "潜水狂热者",
            "prompts": [
                {
                    "id": "default",
                    "name": "默认风格",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/530917/477883-playback-qmrue4.mp3"
                },
                {
                    "id": "238ab849-ac1b-408f-97dc-02645f3fb62d",
                    "name": "高兴",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/964700/450066-playback-o364bm.mp3",
                    "description": "高兴的情感风格"
                }
            ]
        }
    }
}

🟠400请求参数错误

🟠404未找到指定 ID 的语音角色

🔴500服务器内部错误

修改于 2025-02-18 14:09:04

创建新的语音角色

为指定 ID 的语音角色上传头像