Vocu AI 开发者文档
API文档(当前)使用指南返回创作中心
API文档(当前)使用指南返回创作中心
  1. 语音生成
  • 概览
  • 鉴权方式
  • 毫秒级低延迟WebSocket实时生成
  • 语音角色
    • 创建新的语音角色
      POST
    • 为指定 ID 的语音角色添加风格
      POST
    • 为指定 ID 的语音角色上传头像
      POST
    • 通过分享 ID 将语音角色添加到账户中
      POST
    • 获取当前用户的语音角色列表
      GET
    • 获取指定 ID 的语音角色详情
      GET
    • 获取指定ID语音角色的一次性分享链接ID
      GET
    • 删除指定 ID 的语音角色
      DELETE
    • 删除指定 ID 的语音角色的指定 ID 风格
      DELETE
  • 语音生成
    • 同步实时生成语音
      POST
    • 创建异步语音生成任务
      POST
    • 重新生成指定 ID 的异步生成任务
      POST
    • 简易流式生成语音
      GET
    • 获取当前用户的异步生成任务列表
      GET
    • 获取指定 ID 的异步生成任务详情
      GET
    • 删除指定 ID 的异步生成任务
      DELETE
  • 用户账户
    • 获取当前用户账户信息
      GET
  • 文件管理
    • 创建分片上传文件,以便于后续专业克隆使用
      POST
    • 上传分片文件
      POST
    • 完成文件分片上传
      POST
    • 简单上传文件
      POST
  • 内容模板
    • 创建新的模板
      POST
    • 更新指定 ID 的模板
      POST
    • 获取用户的模板列表
      GET
    • 获取指定 ID 的模板详情
      GET
    • 删除指定 ID 的模板
      DELETE
  1. 语音生成

获取指定 ID 的异步生成任务详情

GET
https://v1.vocu.ai/api/tts/generate/{id}
语音生成

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数
id
string 
生成任务 ID
必需
Query 参数
stream
boolean 
可选
如果可用时返回异步任务的流式响应地址
默认值:
false

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v1.vocu.ai/api/tts/generate/?stream'

返回响应

🟢200成功获取异步生成任务详情
application/json
Body
status
integer 
状态码
可选
示例值:
200
message
string 
状态信息
可选
示例值:
OK
data
object (生成任务) 
异步生成任务详情
可选
id
string 
异步生成任务 ID
必需
userId
string 
必需
创建任务的用户 ID
status
enum<string> 
必需
异步任务状态,可以是 pending 等待中 / processing 处理中 / generated 已完成 / failed 任务出错
枚举值:
pendinggeneratedprocessingfailed
type
enum<string> 
必需
任务所使用的模型ID
枚举值:
vocu-neural-voice-001
默认值:
vocu-neural-voice-001
metadata
object 
任务元数据
必需
示例
{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "f13b24d4-6b43-4098-b540-f555344df169",
        "userId": "30a376d1-4ce8-431d-a5af-1e939ce7129f",
        "status": "pending",
        "type": "vocu-neural-voice-001",
        "metadata": {
            "contents": [
                {
                    "voiceId": "ae9c6d66-3850-4df9-9d2c-6de8e03af89f",
                    "text": "鳝鱼在富含桂皮和洋葱的酱汁中文火慢炖,配以奶油般顺滑的裙带菜。",
                    "audio": "https://storage.vocu.ai/generate/b646b47c-46f0-499d-aeb5-e085a0cad7ea/c4e9bc28-1d46-4496-9760-e2870889d44a-10.mp3",
                    "generatedAt": "2003-02-04T22:38:21.667Z"
                }
            ],
            "characters": 29,
            "voices": [
                {
                    "id": "a0fcb4bc-4cb1-4819-b2e4-a926cde4ce8d",
                    "idForGenerate": "1d8eaad3-1c5b-436e-9ed9-f9c439177c57",
                    "name": "励国荣",
                    "status": "pending",
                    "metadata": {
                        "avatar": "https://picsum.photos/seed/Dzlv6hvr/1270/350",
                        "description": "作家,老师,老师",
                        "prompts": [
                            {
                                "id": "054b7f0d-d9c5-4def-8649-f84988648ba6",
                                "name": "全部",
                                "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/203972/995308-playback-ne8hp6.mp3",
                                "description": "整齐的情感风格"
                            },
                            {
                                "id": "ef9c5a2a-b6ee-4e56-82fb-adfb9884aa01",
                                "name": "软",
                                "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/940850/605039-playback-2tlvlw.mp3",
                                "description": "马虎的情感风格"
                            }
                        ]
                    }
                }
            ],
            "temperature": 0.043144503075214446,
            "top_k": 9,
            "top_p": 0.2161284857350636,
            "isPremium": true,
            "audio": "https://storage.vocu.ai/generate/74c108bf-e96c-42fa-a747-3fe88abb608b/ec39bc00-033a-48db-a190-b5f659d55c60-merged.mp3",
            "generatedAt": "1976-10-04T11:51:56.468Z",
            "regenerates": [
                {
                    "contents": [
                        84
                    ],
                    "characters": 91
                },
                {
                    "contents": [
                        85,
                        59,
                        80
                    ],
                    "characters": 68
                }
            ]
        }
    }
}
🟠404未找到指定 ID 的异步生成任务
修改于 2025-02-18 15:06:40
上一页
获取当前用户的异步生成任务列表
下一页
删除指定 ID 的异步生成任务