Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)
User GuideBack To APP
Api Docs(Current)
User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Synchronous
  • Overview
  • Authentication Method
  • Core
    • Voice Character
      • Manage
        • Get the list of voice characters for the current user
        • Get details of the voice character with the specified ID
        • Create a new voice character
        • Update a voice character's name and description
        • Upload avatar for the voice character with the specified ID
        • Delete Voice Character with the specified ID
      • Styles
        • Get the transcription of a style's reference audio
        • Add a style to the voice character with the specified ID
        • Correct the transcription of a style's reference audio
        • Update a style's name and description
        • Set a style as the default style
        • Reset a style and reprocess its reference audio
        • Delete Style of the specified ID for the Voice Character with the specified ID
    • Voice Generation
      • Async jobs
        • Get the list of asynchronous generation tasks for the current user
        • Get the details of an asynchronous generation task by ID
        • Create Asynchronous Voice Generation Task
        • Upload audio for voice conversion
        • Delete an asynchronous generation task by ID
      • Synchronous
        • List synthesis parameter presets
          GET
        • One-shot synthesis returning an MP3 stream directly
          GET
        • Synchronous real-time voice generation
          POST
  • Creative
    • Templates
      • Get User's Template List
      • Get Template Details with Specified ID
      • Create New Template
      • Update Template with Specified ID
      • Delete Template with Specified ID
  • Account
    • User
      • Get current user account information
  • Advanced
    • Splitter
      • List splitter configurations
      • Get splitter configuration details
      • Create a splitter configuration
      • Update a splitter configuration (diff mode)
      • Delete a splitter configuration
  • Schemas
    • Generation Template
    • Generation Task
    • Voice Character
    • General Generation Parameters (New)
    • ErrorResponse
  1. Synchronous

List synthesis parameter presets

GET
https://v1.vocu.ai/api/tts/presets
Return every synthesis parameter preset. A preset is a named combination of sampling parameters (temperature / top_k / top_p, etc.),
referenced via the preset field in /api/tts/generate, /api/tts/simple-generate, and regular Turbo channels.
i18n_name and i18n_description are i18n resource keys, not display-ready copy;
the client must look them up for the current language; config is the sampling parameters actually applied for that preset.
Presets are grouped by voice version (v2_* / v3_*; a _pro suffix is the professional clone variant).
This endpoint does not check anything beyond authentication, and does not return business errors.
INFO
See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Request

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

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 'https://v1.vocu.ai/api/tts/presets' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success
application/json
Query succeeded
Bodyapplication/json

Example
{
    "status": 200,
    "data": [
        {
            "key": "v2_balance",
            "i18n_name": "v2_balance",
            "i18n_description": "v2_balanceDesc",
            "config": {
                "temperature": 0.9,
                "top_k": 1024,
                "top_p": 1,
                "min_p": 0,
                "frequency_penalty": 0,
                "presence_penalty": 0,
                "repetition_penalty": 1,
                "volume": 1
            }
        },
        {
            "key": "v3_balance_pro",
            "i18n_name": "v3_balance_pro",
            "i18n_description": "v3_balance_proDesc",
            "config": {
                "temperature": 1,
                "top_k": 512,
                "top_p": 1,
                "min_p": 0,
                "frequency_penalty": 0,
                "presence_penalty": 0,
                "repetition_penalty": 1,
                "volume": 1
            }
        }
    ]
}
🟠401Unauthorized
🟠429Rate limited
Modified at 2026-08-23 09:24:46
Previous
Delete an asynchronous generation task by ID
Next
One-shot synthesis returning an MP3 stream directly