- Overview
- Authentication method
- Low latency WebSocket real-time generation
- Voice character
- Create new voice characterPOST
- Add style to voice character with specified IDPOST
- Upload avatar for voice character with specified IDPOST
- Add voice character to account via share IDPOST
- Get current user's voice character listGET
- Get voice character details for specified IDGET
- Get one-time share link ID for specified voice character IDGET
- Delete voice character with specified IDDELETE
- Delete specified ID style of voice character with specified IDDELETE
- Create new voice character
- Voice generation
- Synchronous real-time voice generationPOST
- Create asynchronous voice generation taskPOST
- Regenerate asynchronous generation task for specified IDPOST
- Simple streaming voice generationGET
- Get current user's asynchronous generation task listGET
- Get asynchronous generation task details for specified IDGET
- Delete asynchronous generation task with specified IDDELETE
- Synchronous real-time voice generation
- User account
- File management
- Content template
Add style to voice character with specified 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": "Happy",
"prompt": "data:audio/wav;base64,fMRLm9LywDeweSOsz0q9zahvHoMrnLvoUTippGeXDe33z0S8hs5tpRcTG3MY8QwG2N8aqVUiYNACiFJOa8OVI7n7JXdAN694A4XyAVQCu4GUjy6z0d3SiWmdolGKcKTQJ0V4PK25bgp9Jyp5uNAJDGZCHxErLo5fiTKffWmuDI3hboQUfbP3kRKQl746HMcemZrMoGeyWbtc8XBujLquIFGm9ZPsNWQNIIM1k9VuwJ5vIIYpg8lPjpikAHhPr5f3MVaS5U3XgbLlHk04zmokryHpvU54xs4asiHcRM0gaKHyM03HlxaH3nkN6FY39rJeTZtS5DZ1Tgn1jK3F8zVKFFOAx8wavYFuEiriRZO4IqwN5v7mNVqgJgYyH9TgcNnUmRP4WRwjcpWHZAZ1NPBB629y1XIt3ScxB16g4bdMOahsWQg1qJ6c9wJElSAzsiq6Z75gAR0f5Z1IvpqSSgBxMcMyVc5QgFHd3F5ldsZ2ExXNvlPZdqgm",
"description": "Happy emotional style",
"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": "Happy",
"prompt": "data:audio/wav;base64,fMRLm9LywDeweSOsz0q9zahvHoMrnLvoUTippGeXDe33z0S8hs5tpRcTG3MY8QwG2N8aqVUiYNACiFJOa8OVI7n7JXdAN694A4XyAVQCu4GUjy6z0d3SiWmdolGKcKTQJ0V4PK25bgp9Jyp5uNAJDGZCHxErLo5fiTKffWmuDI3hboQUfbP3kRKQl746HMcemZrMoGeyWbtc8XBujLquIFGm9ZPsNWQNIIM1k9VuwJ5vIIYpg8lPjpikAHhPr5f3MVaS5U3XgbLlHk04zmokryHpvU54xs4asiHcRM0gaKHyM03HlxaH3nkN6FY39rJeTZtS5DZ1Tgn1jK3F8zVKFFOAx8wavYFuEiriRZO4IqwN5v7mNVqgJgYyH9TgcNnUmRP4WRwjcpWHZAZ1NPBB629y1XIt3ScxB16g4bdMOahsWQg1qJ6c9wJElSAzsiq6Z75gAR0f5Z1IvpqSSgBxMcMyVc5QgFHd3F5ldsZ2ExXNvlPZdqgm",
"description": "Happy emotional style",
"enhance": false
}'Responses
🟢200Successfully added character style
application/json
Body
Example
{
"status": 200,
"message": "OK",
"data": {
"id": "22454287-ecbd-499c-9ccb-c60f2d38acc7",
"idForGenerate": "3192abc5-9ab0-4235-be44-eb8a336338b9",
"name": "Qian Lifang",
"status": "lora-pending",
"metadata": {
"avatar": "https://loremflickr.com/2252/1664?lock=6544168410253842",
"description": "Diving enthusiast",
"prompts": [
{
"id": "default",
"name": "Default Style",
"promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/530917/477883-playback-qmrue4.mp3"
},
{
"id": "238ab849-ac1b-408f-97dc-02645f3fb62d",
"name": "Happy",
"promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/964700/450066-playback-o364bm.mp3",
"description": "Happy emotional style"
}
]
}
}
}🟠400Request parameter error
🟠404Voice character with specified ID not found
🔴500Internal Server Error
Modified at 2025-08-09 14:13:36