创建剪辑数据任务

POST

/v1/tasks/generate-clip-data

根据文案生成视频剪辑指令，配置配音、BGM、字幕样式。

标准模式（从解说文案生成）：

generate_task_id — 解说文案任务 ID

快速模式（从快速文案生成）：

clip_file_id — 剪辑数据文件 ID

writing_task_id — 快速文案任务 ID

必填参数：

dubbing — 配音名称（通过 GET /v1/resources/voices 获取）

bgm_file_id — BGM 文件 ID 或 NO_BGM

可选参数：

subtitle_style — 字幕样式（字号、颜色、粗细）

custom_cover — 自定义封面

输出： 剪辑数据 JSON，用于视频合成任务

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Header 参数

Body 参数application/json必填

示例

{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "generate_writing_task_id": "string",
    "dubbing": "string",
    "dubbing_type": "",
    "bgm_file_id": "string",
    "custom_cover": [
        "string"
    ],
    "subtitle_style": {
        "Fontsize": 0,
        "PrimaryColour": "string",
        "OutlineColour": "string",
        "Bold": 0
    },
    "font_path": "string",
    "result_output_path": "string",
    "model_version": "advanced",
    "task_count": 1,
    "callback_data": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/tasks/generate-clip-data' \
--header 'x-code;' \
--header 'app-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "generate_writing_task_id": "string",
    "dubbing": "string",
    "dubbing_type": "",
    "bgm_file_id": "string",
    "custom_cover": [
        "string"
    ],
    "subtitle_style": {
        "Fontsize": 0,
        "PrimaryColour": "string",
        "OutlineColour": "string",
        "Bold": 0
    },
    "font_path": "string",
    "result_output_path": "string",
    "model_version": "advanced",
    "task_count": 1,
    "callback_data": "string"
}'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "task_id": "string",
        "status": 0,
        "estimated_points": 0,
        "message": "Task created"
    }
}

🟠422Parameter Error

修改于 2026-07-10 07:58:13

创建视频合成任务

创建视觉模板视频任务