Create new template

POST

https://v1.vocu.ai/api/template

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "name": "Food Introduction",
    "description": "Generation template containing various food introductions",
    "contents": [
        {
            "voiceId": "b32c9ae9-845f-4627-ab1e-3444d8d880fc",
            "text": "A heartwarming Anhui cuisine soup made with fresh tuna and seasoned with traditional spices, aromatic and appetizing."
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/template' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Food Introduction",
    "description": "Generation template containing various food introductions",
    "contents": [
        {
            "voiceId": "b32c9ae9-845f-4627-ab1e-3444d8d880fc",
            "text": "A heartwarming Anhui cuisine soup made with fresh tuna and seasoned with traditional spices, aromatic and appetizing."
        }
    ]
}'

Responses

🟢200Successfully created template

application/json

Body

Example

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "77f54dab-6e96-4c11-afac-2db3f99e4b02",
        "name": "Food Introduction",
        "contents": [
            {
                "metaVoiceId": 22,
                "text": "Fresh mixed salad with black pepper marinated pork and broccoli, drizzled with a light dressing."
            },
            {
                "metaVoiceId": 31,
                "text": "Our golden duck meat, slow-cooked to perfection, served with steamed spinach and rich gravy."
            }
        ],
        "metadata": {
            "metaVoiceId": 81,
            "description": "Template containing various food introductions"
        },
        "userId": "b3ed390b-e26f-4657-8458-67a8290514a1",
        "from": "self",
        "originId": "2e4ad6df-900d-4843-9d65-1a385552b12d"
    }
}

🟠400Request parameter error

Modified at 2025-08-09 14:31:37

Simple file upload

Update template with specified ID