- 概览
- 鉴权方式
- 毫秒级低延迟WebSocket实时生成
- 语音角色
- 语音生成
- 用户账户
- 文件管理
- 内容模板
获取指定 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
必需
status
enum<string>
必需
枚举值:
pendinggeneratedprocessingfailed
type
enum<string>
必需
枚举值:
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