创建新的模板

POST

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

name

string

模板名称

必需

description

string

模板描述

可选

contents

array [object {2}]

模板内容列表

可选

voiceId

string

语音角色 ID

必需

text

string

文本内容

必需

示例

{
    "name": "食物介绍",
    "description": "包含了各种食物介绍的生成模板",
    "contents": [
        {
            "voiceId": "b32c9ae9-845f-4627-ab1e-3444d8d880fc",
            "text": "一碗暖心的徽菜汤，选用新鲜的金枪鱼，并用传统香料调味，芳香扑鼻。"
        },
        {
            "voiceId": "a518fcf8-2eff-44f3-95bd-53ba5668bcf0",
            "text": "一款令人愉悦的果挞，融合了多汁的的南瓜和甜美的甜瓜，装在一个黄油味十足的酥皮壳中，最后淋上一丝灯笼椒提味。"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/template' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "食物介绍",
    "description": "包含了各种食物介绍的生成模板",
    "contents": [
        {
            "voiceId": "b32c9ae9-845f-4627-ab1e-3444d8d880fc",
            "text": "一碗暖心的徽菜汤，选用新鲜的金枪鱼，并用传统香料调味，芳香扑鼻。"
        },
        {
            "voiceId": "a518fcf8-2eff-44f3-95bd-53ba5668bcf0",
            "text": "一款令人愉悦的果挞，融合了多汁的的南瓜和甜美的甜瓜，装在一个黄油味十足的酥皮壳中，最后淋上一丝灯笼椒提味。"
        }
    ]
}'

返回响应

🟢200成功创建模板

application/json

Body

status

integer

状态码

必需

示例值:

200

message

string

状态信息

必需

示例值:

data

object (生成模板)

创建的模板详情

必需

string

模板 ID

必需

name

string

模板名称

必需

contents

array [object {2}]

模板内容列表

必需

metadata

object

模版元数据

必需

userId

string

必需

创建模板的用户 ID

from

enum<string>

必需

模板来源，可以是self（自行创建）/ community（来自社区）

枚举值:

selfcommunity

originId

string

可选

原始模板 ID（若来自社区）

示例

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "77f54dab-6e96-4c11-afac-2db3f99e4b02",
        "name": "食物介绍",
        "contents": [
            {
                "metaVoiceId": 22,
                "text": "新鲜的什锦沙拉，混合了黑胡椒腌制的猪肉、西兰花，淋上少许调味汁。"
            },
            {
                "metaVoiceId": 31,
                "text": "我们的金黄色的鸭肉，慢火烹饪至完美状态，配以蒸菠菜和浓郁的肉汁。"
            }
        ],
        "metadata": {
            "metaVoiceId": 81,
            "description": "包含各种食物介绍的模板"
        },
        "userId": "b3ed390b-e26f-4657-8458-67a8290514a1",
        "from": "self",
        "originId": "2e4ad6df-900d-4843-9d65-1a385552b12d"
    }
}

🟠400请求参数错误

修改于 2025-02-18 15:26:08

简单上传文件

更新指定 ID 的模板