为指定 ID 的语音角色上传头像
POST
/api/voice/{id}/avatar
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Path 参数
Body 参数application/json
示例
{
"avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIxMzQ2IiBoZWlnaHQ9IjI3ODAiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjY2E4NjgiLz48dGV4dCB4PSI2NzMiIHk9IjEzOTAiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MTM0NngyNzgwPC90ZXh0Pjwvc3ZnPg=="
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://v1.wusound.cn/api/voice//avatar' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIxMzQ2IiBoZWlnaHQ9IjI3ODAiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjY2E4NjgiLz48dGV4dCB4PSI2NzMiIHk9IjEzOTAiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MTM0NngyNzgwPC90ZXh0Pjwvc3ZnPg=="
}'返回响应
🟢200成功上传头像
application/json
Body
示例
{
"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.voc.ink/prompt/260913/535265-playback-xe595e.mp3"
}
]
}
}
}🟠400请求参数错误
🟠404未找到指定 ID 的语音角色
🔴500服务器内部错误
修改于 2025-11-21 15:25:40