Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)
User GuideBack To APP
Api Docs(Current)
User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Templates
  • 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
        • One-shot synthesis returning an MP3 stream directly
        • Synchronous real-time voice generation
  • Creative
    • Templates
      • Get User's Template List
        GET
      • Get Template Details with Specified ID
        GET
      • Create New Template
        POST
      • Update Template with Specified ID
        POST
      • Delete Template with Specified ID
        DELETE
  • 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. Templates

Get User's Template List

GET
https://v1.vocu.ai/api/template
offset / limit pagination, no cursor; detect the last page when fewer items than limit are returned. See the "Pagination" document. Results are sorted by createdAt descending, scoped to the current user, and exclude deleted rows.
from accepts only library (imported from the asset library) and self (user-created); any other value silently drops the filter and returns everything rather than raising an error.
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 ********************
Query Params

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/template?offset=undefined&limit=undefined&from=undefined' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Template List Retrieved Successfully
application/json
Template list (a plain array with no total)
Bodyapplication/json

Example
{
    "status": 200,
    "message": "OK",
    "data": [
        {
            "id": "0678834d-bc6a-48c3-8e9e-9eb9ecf32264",
            "name": "Food Template",
            "contents": [
                {
                    "metaVoiceId": 41,
                    "text": "Eel slow-simmered in a rich sauce with pickled celery and beets, accompanied by creamy turnip."
                },
                {
                    "metaVoiceId": 1,
                    "text": "A special turquoise green bean from the Republic of the Congo. To support its rich flavor, it is served with a large spoonful of orange peel."
                },
                {
                    "metaVoiceId": 35,
                    "text": "Our spicy snake meat, slow-cooked to perfection, served with steamed okra and a rich gravy."
                }
            ],
            "metadata": {
                "metaVoiceId": 19,
                "description": "Template containing many food descriptions"
            },
            "userId": "939e79e0-24f3-44fe-b03c-efb0912f1fac",
            "from": "community",
            "originId": "5d07d7d5-b70d-4666-b3f4-a916bbc75140"
        }
    ]
}
🟠401Unauthorized
🟠429Rate limited
Modified at 2026-08-23 09:24:46
Previous
Synchronous real-time voice generation
Next
Get Template Details with Specified ID