创建Remotion 视频渲染任务

POST

/v2/task/commentary/create_remotion_video

参数说明:

mode: 模式 one_stop (一站式模式), staged (阶段式)

task_id: 当模式 one_stop 的话，第三步视频合成任务的task_id必须填写

file_id: staged 模式下剪辑脚本字幕文件的file_id（用于计算点数）

clip_data: staged 模式下剪辑脚本文件数据，json 格式

template_record_id: 模板记录ID列表，支持多个模板

template_params: 模板参数（可选），key为模板记录ID，value为参数字典

staged 模式下 file_id 和 clip_data 只需要填写一个即可

错误码说明:

10009: 点数不足

60000: 可重试的错误（Gradio服务临时故障、超时等）

请求参数

Body 参数application/json必填

示例

{
    "task_id": "023bcca1c0ec4790bff440fcbf717511",
    "mode": "one_stop",
    "file_id": "",
    "clip_data": "",
    "template_record_id": [
        "21",
        "20",
        "19"
    ],
    "template_params": {
        "21": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        },
        "20": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        },
        "19": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/task/commentary/create_remotion_video' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_id": "023bcca1c0ec4790bff440fcbf717511",
    "mode": "one_stop",
    "file_id": "",
    "clip_data": "",
    "template_record_id": [
        "21",
        "20",
        "19"
    ],
    "template_params": {
        "21": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        },
        "20": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        },
        "19": {
            "segment_count": 2,
            "slogan": "顶部标语",
            "vertical_text_content": "左下标语"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-04-09 07:34:34

查询爆款解说模型版本

获取 Remotion 模板列表