详细参数

版本记录

日期	更新概要
2026-10-16	新增离线视频编辑接口说明：创建任务 `POST /ent/s_editing/offline`、查询任务与成片、错误码。

创建任务

提交一段源视频与一组按视频时间排列的场景切换，异步生成一段 MP4。

请求示例

curl -X POST "$BASE_URL/ent/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"}
    ]
  }'

响应示例

{
  "task_id": 900000000000000101,
  "state": "created",
  "model": "vidu-s2-editing",
  "credits": 0,
  "created_at": "2026-10-16T10:00:00Z",
  "resolution": "540p"
}

请求参数

modelstring

模型标识，缺省 vidu-s2-editing

videostring必填

必填，源视频地址（http(s) GET 地址或 ssuploadid）；不支持 base64。要求 MP4 / H.264、540p（短边为540像素）、24fps，≤1 GiB，≤30分钟

resolutionString

输出的分辨率，540P（默认）、720P、1080P、2K

actionsobject[]

是，场景切换列表，1~32 条，字段见下方「actions[] 对象字段」

watermarkbool

否，是否加水印，缺省 true

wm_positionenum

「内容由 AI 生成」标识在画面中的位置，仅在 watermark=true 时生效。可选值：top_left、top_right、bottom_left、bottom_right；默认 bottom_right。注意：该字段控制的是 AI 生成合规标识的位置，Vidu 品牌水印固定在右下角，不受此字段影响。枚举名不合法时请求会返回 400；未传时按默认位置处理

wm_urlstring

否，自定义水印图片地址（http(s)）

callback_urlstring

否，结果回调地址

payloadstring

否，透传字段，回调时原样返回

meta_datastring

否，透传元数据

actions[] 对象字段

time_snumber

在源视频时间线上发起切换的秒数（可有小数）。首条必须为 0，后续严格递增

image_uristring

本次场景的参考图地址（http(s) 或 ssuploadid，或 base64 data URI）

editing_typeenum

选填；场景类型，取值见下方「editing_type 枚举值」；不传按 style_transfer 处理

editing_type 枚举值

值	场景	参考图含义
`style_transfer`	风格迁移	目标视觉风格
`virtual_tryon`	虚拟试衣	目标服饰
`subject_replacement`	主体替换	目标主体
`background_replacement`	背景替换	目标背景

规则：

actions 1~32 条；time_s 非首条 0 或非严格递增、image_uri 为空均返回 400；editing_type 不传或缺省为 unspecified 时按 style_transfer 处理，传入未知取值返回 400。
time_s 为「发起切换」时刻，成片生效时刻可能略晚（预计 1~2 秒），不承诺逐帧命中。
发起时刻 ≥ 成片时长 的条目会被忽略（不影响任务成功）；新场景替换当前场景，持续到下一条或成片结束。

响应参数

字段	说明
`task_id`	任务 ID
`state`	状态，创建成功为 `created`
`model`	模型回显
`credits`	创建期返回 `0`；实际扣费在任务工作流内按源视频时长 × 1.5 发生，经任务查询回显
`payload`	透传回显
`created_at`	创建时间
`resolution`	成片分辨率（固定 540p）

查询任务与成片

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

错误码

场景	HTTP	说明
`actions` 结构非法	400	返回具体字段错误
缺 `video`	400	`video` 必填
`model` 非法	400	模型未登记
积分不足	400	`CreditInsufficient`
源视频规格不符 / 素材不可下载 / 推理或上传失败	创建 200，轮询 `failed`	`err_code` 为 `OFFLINE_EDITING_*`
输入素材或成片审核未通过	创建 200，轮询 `failed` / 成片审核失败	—

计费说明

按视频时长计费，每秒1积分（0.03125元），时长按输入视频实际时长向上取整。
余额低于 45 积分（约1.4元）就不能发起任务
积分扣除时机：创建接口只做余额预检，不扣积分；任务进入排队时按预估时长一次性预扣。任务失败或未产出生成物时，未实际消耗的部分会自动退还；最终扣减结果以查询接口返回的 credits 为准（failed 时为 0）。