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

POST

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

语音角色

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

string

语音角色 ID

必需

Body 参数application/json

avatar

string

必需

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

示例

{
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIxMzQ2IiBoZWlnaHQ9IjI3ODAiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjY2E4NjgiLz48dGV4dCB4PSI2NzMiIHk9IjEzOTAiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MTM0NngyNzgwPC90ZXh0Pjwvc3ZnPg=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/tts/voice//avatar' \
--header 'Content-Type: application/json' \
--data-raw '{
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIxMzQ2IiBoZWlnaHQ9IjI3ODAiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjY2E4NjgiLz48dGV4dCB4PSI2NzMiIHk9IjEzOTAiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MTM0NngyNzgwPC90ZXh0Pjwvc3ZnPg=="
}'

返回响应

🟢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": "042391f5-5887-403f-a42c-1a67680625bc",
        "idForGenerate": "3c83796b-8cc8-4b8e-a3e2-61761d4d258e",
        "name": "端宇航",
        "status": "pending",
        "metadata": {
            "avatar": "https://picsum.photos/seed/RsqU7i/371/940",
            "description": "企业家，发明家，活动家",
            "prompts": [
                {
                    "id": "31ef37b0-a4b7-4c87-b6d1-4abfe8725027",
                    "name": "大大咧咧",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/260913/535265-playback-xe595e.mp3"
                }
            ]
        }
    }
}

🟠400请求参数错误

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

🔴500服务器内部错误

修改于 2025-02-18 14:13:53

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

通过分享 ID 将语音角色添加到账户中