Vocu Developers
🇨🇳 简体中文
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)User GuideBack To APP
Api Docs(Current)User GuideBack To APP
🇨🇳 简体中文
  • 🇺🇸 English
  • 🇨🇳 简体中文
  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. 语音角色

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

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

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Body Params application/json

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

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://v1.vocu.ai/api/tts/voice//prompt' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "高兴",
    "prompt": "data:audio/wav;base64,fMRLm9LywDeweSOsz0q9zahvHoMrnLvoUTippGeXDe33z0S8hs5tpRcTG3MY8QwG2N8aqVUiYNACiFJOa8OVI7n7JXdAN694A4XyAVQCu4GUjy6z0d3SiWmdolGKcKTQJ0V4PK25bgp9Jyp5uNAJDGZCHxErLo5fiTKffWmuDI3hboQUfbP3kRKQl746HMcemZrMoGeyWbtc8XBujLquIFGm9ZPsNWQNIIM1k9VuwJ5vIIYpg8lPjpikAHhPr5f3MVaS5U3XgbLlHk04zmokryHpvU54xs4asiHcRM0gaKHyM03HlxaH3nkN6FY39rJeTZtS5DZ1Tgn1jK3F8zVKFFOAx8wavYFuEiriRZO4IqwN5v7mNVqgJgYyH9TgcNnUmRP4WRwjcpWHZAZ1NPBB629y1XIt3ScxB16g4bdMOahsWQg1qJ6c9wJElSAzsiq6Z75gAR0f5Z1IvpqSSgBxMcMyVc5QgFHd3F5ldsZ2ExXNvlPZdqgm",
    "description": "高兴的情感风格",
    "enhance": false
}'

Responses

🟢200成功添加角色风格
application/json
Body

Example
{
    "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服务器内部错误
Modified at 2025-09-07 16:11:28
Previous
创建新的语音角色
Next
为指定 ID 的语音角色上传头像