整体介绍

这是 Vidu S 产品面向提供的视频文件编辑能力：对一段已经录制好的源视频，按时间轴提交一组场景切换，异步生成一段编辑后的 MP4。与实时编辑直播流不同，它不是流式的——不建立长连接，一次提交对应一次完整的编辑任务，通过轮询或回调获取结果。

四种能力	介绍
风格渲染 `style_transfer`	按参考图风格重绘视频画面，常见于二次元化、艺术风格化的成片剪辑。
角色替换 `subject_replacement`	把视频中的人物替换为参考图角色，保留原有动作与镜头节奏。
背景替换 `background_replacement`	替换视频背景为参考图场景，保持主体与前景关系不变。
虚拟换衣 `virtual_tryon`	按参考图为视频中的人物换装，保持姿态与身体结构。

最小接入流程

创建任务

HTTP 提交源视频与场景切换

提交源视频地址与一组按时间排列的场景切换，拿到 task_id 用于后续查询。

curl -X POST "$BASE_URL/s_editing/offline" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-s2-editing",
    "video": "https://example.com/input/source.mp4",
    "actions": [
      {"time_s": 0,   "image_uri": "https://example.com/input/style.jpg",  "editing_type": "style_transfer"},
      {"time_s": 1.5, "image_uri": "https://example.com/input/clothes.png","editing_type": "virtual_tryon"}
    ]
  }'

成片分辨率为 540p、24fps，宽高与显示方向与源视频一致；成片时长等于源视频时长（不补长、不截断）。

查询任务与获取成片

轮询任务状态并读取成片地址

创建成功只代表任务已受理，不代表成片已生成，需用 task_id 轮询查询，或配置 callback_url 等待回调。

任务状态：GET /v2/tasks（可按任务 id 过滤），终态为 success / failed。
成片：GET /v2/tasks/{task_id}/creations，返回成片视频地址（及封面/尾帧）。

接口协议概述

接入全流程

调用「创建任务」接口，提交源视频与按时间排列的场景切换序列，获得 task_id。
轮询「查询任务」接口直至进入终态 success 或 failed（也可配置 callback_url 接收回调，免去轮询）。
success 后调用「查询成片」接口，获取生成的视频地址。

接口总览

接口	方法与路径	用途
POST	`/s_editing/offline`	创建离线编辑任务（提交源视频与场景切换序列，返回 `task_id`）
GET	`/v2/tasks`	查询任务状态（可按任务 id 过滤）
GET	`/v2/tasks/{task_id}/creations`	获取成片视频地址

通用约定

约定	说明
接入环境与鉴权	基础地址与鉴权沿用现有 Vidu MaaS 开放 API（同其他 `/s_`、`/v2/` 接口）。
数据格式	`Content-Type: application/json`
异步与轮询	任务为异步处理，创建成功只代表任务已受理，不代表成片已生成；需轮询查询接口，或配置 `callback_url` 等待回调。
计费	创建接口返回 `credits` 为 `0`，实际扣费在任务工作流内按源视频时长 × 1.5 发生，经「查询任务」结果回显。