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. 语音生成

获取当前用户的异步生成任务列表

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

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
limit
integer 
每页数量
可选
默认值:
20
offset
integer 
偏移量
可选
默认值:
0
status
enum<string> 
任务状态
可选
枚举值:
pendingprocessinggeneratedfailed
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?limit&offset&status&stream'

返回响应

🟢200成功获取生成任务列表
application/json
Body
status
integer 
状态码
必需
示例值:
200
message
string 
状态信息
必需
示例值:
OK
data
array[object (生成任务) {5}] 
生成任务列表
必需
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": "9b138315-98c2-4970-9abd-962cb7418bac",
            "userId": "2b4fde6a-1444-4470-be24-55b8719a87b3",
            "status": "generated",
            "type": "vocu-neural-voice-001",
            "metadata": {
                "contents": [
                    {
                        "voiceId": "76db42d3-5538-499f-a70f-555ff83680d3",
                        "text": "一只烤至外皮新鲜的、苦涩的的灰喜鹊,填满了绿豆芽,淋上苹果酱。配菜有山莓泥和野生红椒。",
                        "audio": "https://storage.vocu.ai/generate/4b969e1f-0d77-4538-84e4-9a0e606a21ac/628c0e1c-9ba6-4821-ab8e-16c264b600b3-8.mp3",
                        "generatedAt": "1970-03-02T23:16:35.105Z"
                    }
                ],
                "characters": 94,
                "voices": [
                    {
                        "id": "c874f28a-e23d-4d9f-a744-01f3e45be651",
                        "idForGenerate": "6232c5af-47f7-490f-b461-3bd598ff8667",
                        "name": "前国华",
                        "status": "lora-failed",
                        "metadata": {
                            "avatar": "https://loremflickr.com/562/2359?lock=8568681027833999",
                            "description": "发明家,博主,工程师🇷🇺",
                            "prompts": [
                                {
                                    "id": "0fe0b699-dbaa-4fdd-b149-e80d8113cf21",
                                    "name": "伟大",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/457124/476565-playback-tptjom.mp3",
                                    "description": "整齐的情感风格"
                                },
                                {
                                    "id": "aa9b80a4-beee-49a7-a7b2-b71ae18ca5d9",
                                    "name": "好些",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/971752/343529-playback-wlzm8p.mp3",
                                    "description": "鲁莽的情感风格"
                                },
                                {
                                    "id": "4e590a0e-65bd-4676-bc7d-d2cea80e25bf",
                                    "name": "小",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/711847/494025-playback-h98c2r.mp3",
                                    "description": "鲁莽的情感风格"
                                }
                            ]
                        }
                    },
                    {
                        "id": "3597b8e9-f3b8-453f-865e-34c3d094b43d",
                        "idForGenerate": "b82a9e9b-0393-4346-9781-2162f938b35a",
                        "name": "浦奕辰",
                        "status": "lora-success",
                        "metadata": {
                            "avatar": "https://picsum.photos/seed/RPmlfzBUTj/3309/2429",
                            "description": "活动家,个人,朋友🌯",
                            "prompts": [
                                {
                                    "id": "6528bbc7-617d-4a22-aea8-10cbd7566cab",
                                    "name": "硬",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/861449/126997-playback-t0xemq.mp3",
                                    "description": "整齐的情感风格"
                                },
                                {
                                    "id": "e72eaf83-cccd-4a2b-9393-ddb9fd8e6a5b",
                                    "name": "绿油油",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/761434/954936-playback-dd1gbw.mp3",
                                    "description": "全部的情感风格"
                                },
                                {
                                    "id": "49ec8c8f-a963-4c94-82cf-3347017b4890",
                                    "name": "干脆",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/537729/047704-playback-yvp6qw.mp3",
                                    "description": "生动的情感风格"
                                }
                            ]
                        }
                    }
                ],
                "temperature": 0.8200606622426785,
                "top_k": 10,
                "top_p": 0.09479270268635487,
                "isPremium": false,
                "audio": "https://storage.vocu.ai/generate/6014e988-8d4b-487d-bd61-aa2821d465c8/23703261-4f67-46dd-b271-71ee09d53301-merged.mp3",
                "generatedAt": "1948-07-01T11:05:16.703Z",
                "regenerates": [
                    {
                        "contents": [
                            68,
                            86,
                            29
                        ],
                        "characters": 82
                    },
                    {
                        "contents": [
                            28
                        ],
                        "characters": 70
                    }
                ]
            }
        },
        {
            "id": "c07429ad-5d03-494e-b720-4cc870002631",
            "userId": "b2b6724a-d6bb-410c-a5bd-7c6cdff24037",
            "status": "generated",
            "type": "vocu-neural-voice-001",
            "metadata": {
                "contents": [
                    {
                        "voiceId": "4abfd541-a70e-412a-bb07-3274e4d1fc71",
                        "text": "嫩滑的狗肉肉串,刷上甜辣哈密瓜酱,盛放在香喷喷的茉莉香米饭上。",
                        "audio": "https://storage.vocu.ai/generate/72b1ac10-33b3-48a2-815d-48161353fe64/d60c5ffa-98dc-4d76-96b4-7178e275dd0b-9.mp3",
                        "generatedAt": "1970-09-12T13:22:47.705Z"
                    }
                ],
                "characters": 44,
                "voices": [
                    {
                        "id": "350bb7ad-d67a-410b-b41a-9d7b4829fc2c",
                        "idForGenerate": "2186208c-a9d2-486e-b3e9-f4e1e40202d1",
                        "name": "司徒梓浩",
                        "status": "pending",
                        "metadata": {
                            "avatar": "https://loremflickr.com/1645/2500?lock=7457550936617771",
                            "description": "账户粉丝🥛",
                            "prompts": [
                                {
                                    "id": "f48b6d9e-a279-4fcc-92bd-b96c13ff9a99",
                                    "name": "甜",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/084716/610271-playback-s0a93r.mp3",
                                    "description": "干脆的情感风格"
                                },
                                {
                                    "id": "9b43b711-6921-480b-b926-26c5692c5e1a",
                                    "name": "伟大",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/911054/652403-playback-k5ri4j.mp3",
                                    "description": "轻松的情感风格"
                                },
                                {
                                    "id": "5fda63a6-bb3c-4ef7-9b15-aea501f307e0",
                                    "name": "红",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/716158/757771-playback-o9dyoc.mp3",
                                    "description": "轻松的情感风格"
                                }
                            ]
                        }
                    },
                    {
                        "id": "b98ad8aa-5b68-4183-9b2f-7cc61caa0ba4",
                        "idForGenerate": "eaf60900-4872-493a-910f-d03714fac6f1",
                        "name": "应娟",
                        "status": "lora-success",
                        "metadata": {
                            "avatar": "https://loremflickr.com/939/3155?lock=4040111516752034",
                            "description": "活动家,企业主,发明家👨🏼‍❤️‍👨🏼",
                            "prompts": [
                                {
                                    "id": "59a08a65-5100-4649-9305-90556ed123c6",
                                    "name": "硬",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/383858/772147-playback-67psbe.mp3",
                                    "description": "优秀的情感风格"
                                },
                                {
                                    "id": "c366c992-29f5-47fb-888f-fa48c0da6978",
                                    "name": "笔直",
                                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/923232/254264-playback-4h56d3.mp3",
                                    "description": "勇敢的情感风格"
                                }
                            ]
                        }
                    }
                ],
                "temperature": 0.6741124483789291,
                "top_k": 80,
                "top_p": 0.055122424043944074,
                "isPremium": true,
                "audio": "https://storage.vocu.ai/generate/1e67b5d3-56ec-4be1-b0d4-f4cd3f6aef8a/3437aa2a-f01d-4845-b257-ebd89d320a59-merged.mp3",
                "generatedAt": "2020-07-27T11:33:43.891Z",
                "regenerates": [
                    {
                        "contents": [
                            55
                        ],
                        "characters": 86
                    },
                    {
                        "contents": [
                            62
                        ],
                        "characters": 14
                    },
                    {
                        "contents": [
                            91,
                            32,
                            45
                        ],
                        "characters": 63
                    }
                ]
            }
        }
    ]
}
修改于 2025-02-18 15:06:10
上一页
简易流式生成语音
下一页
获取指定 ID 的异步生成任务详情