Wusound悟声 - 开发者文档
使用指南返回悟声首页
使用指南返回悟声首页
  1. 语音角色
  • 概览
  • 鉴权方式
  • 语音角色
    • 创建新的语音角色
      POST
    • 为指定 ID 的语音角色添加风格
      POST
    • 为指定 ID 的语音角色上传头像
      POST
    • 通过分享 ID 将语音角色添加到账户中
      POST
    • 获取当前用户的语音角色列表
      GET
    • 获取指定 ID 的语音角色详情
      GET
    • 获取指定ID语音角色的一次性分享链接ID
      GET
    • 删除指定 ID 的语音角色
      DELETE
    • 删除指定 ID 的语音角色的指定 ID 风格
      DELETE
  • 语音生成
    • 同步实时生成语音
      POST
    • 创建异步语音生成任务
      POST
    • 获取当前用户的异步生成任务列表
      GET
    • 获取指定 ID 的异步生成任务详情
      GET
    • 删除指定 ID 的异步生成任务
      DELETE
  • 用户账户
    • 获取当前用户账户信息
      GET
  • 内容模板
    • 创建新的模板
      POST
    • 更新指定 ID 的模板
      POST
    • 获取用户的模板列表
      GET
    • 获取指定 ID 的模板详情
      GET
    • 删除指定 ID 的模板
      DELETE
  • 数据模型
    • 语音角色
    • 通用生成参数
    • 生成任务
    • 生成模板
  1. 语音角色

创建新的语音角色

POST
/api/voice

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json

示例
{
    "name": "Brandi Grady",
    "prompt": "data:audio/wav;base64,X2WDzbOHAPf88clAqELykihJsChXfWwV1C4Oqx9nFyZp82bzq4EOcrzuCWAIiU9AOovOJRMQRJjkslpXTJuNf5D8wfdrfCRM1JHqktqEDCeFVgZhfl2pVbcRyWDVEybArGf4KCYDIJC9DlpdxZIqXDBOPIznQ5RuyACOKx9HN0zzfVtKeAbW7ujKTiRR3DiHsTrWq7g11bLKznC5Lzjg0cEN0bPDnZdEvs0acuOzRFSQCAoweCyCrkBJv0KM9EjOyRlvsGby7Zqg4odsDqok6NmhN0wpmcoUO7cHjoVitVtnBHtjrf3SpnQ2YhRyEDnWql5i12thBqF6lpZ2j8RjxW4HYBkcdSRkJxZC1QzHdozblKfbkaRJ26Z3Rz2t2mY98pxNUmpHiJD8PWSTJbg3q0YLXu2pFFZ729XN2aGTRA3imzfsjE6vNtN4j8PM7HieHw9yHhX15W4QPJyrTtNVdVj8O3eVYmNlQmwiMNlYfdU2tpZfdxNE",
    "modelVersion": "v3.0",
    "language": "fr",
    "description": "founder",
    "avatar": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIzMzQ4IiBoZWlnaHQ9IjE5NjIiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjNzJlYzMiLz48dGV4dCB4PSIxNjc0IiB5PSI5ODEiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MzM0OHgxOTYyPC90ZXh0Pjwvc3ZnPg==",
    "vocalFilter": false,
    "lora": "71b6711b-9c03-47f4-acfb-bd94dadbaed8"
}

请求示例代码

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' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Brandi Grady",
    "prompt": "data:audio/wav;base64,X2WDzbOHAPf88clAqELykihJsChXfWwV1C4Oqx9nFyZp82bzq4EOcrzuCWAIiU9AOovOJRMQRJjkslpXTJuNf5D8wfdrfCRM1JHqktqEDCeFVgZhfl2pVbcRyWDVEybArGf4KCYDIJC9DlpdxZIqXDBOPIznQ5RuyACOKx9HN0zzfVtKeAbW7ujKTiRR3DiHsTrWq7g11bLKznC5Lzjg0cEN0bPDnZdEvs0acuOzRFSQCAoweCyCrkBJv0KM9EjOyRlvsGby7Zqg4odsDqok6NmhN0wpmcoUO7cHjoVitVtnBHtjrf3SpnQ2YhRyEDnWql5i12thBqF6lpZ2j8RjxW4HYBkcdSRkJxZC1QzHdozblKfbkaRJ26Z3Rz2t2mY98pxNUmpHiJD8PWSTJbg3q0YLXu2pFFZ729XN2aGTRA3imzfsjE6vNtN4j8PM7HieHw9yHhX15W4QPJyrTtNVdVj8O3eVYmNlQmwiMNlYfdU2tpZfdxNE",
    "modelVersion": "v3.0",
    "language": "fr",
    "description": "founder",
    "avatar": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIzMzQ4IiBoZWlnaHQ9IjE5NjIiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNjNzJlYzMiLz48dGV4dCB4PSIxNjc0IiB5PSI5ODEiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MzM0OHgxOTYyPC90ZXh0Pjwvc3ZnPg==",
    "vocalFilter": false,
    "lora": "71b6711b-9c03-47f4-acfb-bd94dadbaed8"
}'

返回响应

🟢200成功创建语音角色
application/json
Body

示例
{
    "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.voc.ink/prompt/062326/734689-playback-kg1wvu.mp3"
                }
            ]
        }
    }
}
🟠400请求参数错误
🟠403没有权限执行该操作
🔴500服务器内部错误
修改于 2025-11-21 15:25:40
上一页
鉴权方式
下一页
为指定 ID 的语音角色添加风格
Built with