tobatsu2 · 工作流入参手册

两个工作流入参怎么填(含范围 + 默认 + 示例)

值都从 skill 实现里核出来的(pip = pip-compose-rendi-test v3 / 字幕 = subtitle-burn-rendi-test v29)。绿=默认值,红=必填。坐标/比例类参数都是 0–1 的小数(占画面的比例),不是像素。

① video_pip_compose_mai — 画中画合成

# 管道参数(Mai 网关自动填,你不用碰)

instruction · source_system=mai · capability=video_pip_compose · gateway_task_id · gateway_run_id · delivery · callback_url · callback_token · main_video_url(主视频)· pip_video_url(画中画视频)

# 可调参数

参数	能填什么	范围	默认
layout	整体布局:`overlay` 浮窗叠加 / `split_v` 上下分屏 / `split_h` 左右分屏	3 选 1	overlay
user_brief	自然语言补充说明(给 agent 看)	文本	—
↓ 仅当 layout = overlay 生效
overlay_position	浮窗放哪:`tl` 左上 / `tr` 右上 / `bl` 左下 / `br` 右下 / `custom` 自定义坐标	5 选 1	tr(右上)
overlay_size	浮窗大小 = 占画面短边的比例。`0.34`=占 34%,`0.5`=半屏	0.12 – 0.80	0.34
overlay_shape	浮窗形状:`circle` 圆 / `square` 方 / `vrect` 竖矩形 / `hrect` 横矩形	4 选 1	circle
overlay_margin	浮窗离画面边的距离 = 画面短边的比例。`0.02`=离边 2%	0.0 – 0.10	0.02
overlay_x	仅 position=custom 时必填。浮窗左上角的横坐标 = 画面宽的比例。`0`=贴最左,`0.5`=中间,`1`=贴最右	0.0 – 1.0	无(custom 必填)
overlay_y	仅 position=custom 时必填。浮窗左上角的纵坐标 = 画面高的比例。`0`=贴顶,`0.7`=偏下,`1`=贴底	0.0 – 1.0	无(custom 必填)
↓ 仅当 layout = split_v / split_h 生效
split_pip_side	PIP(数字人)放分屏的哪半:`first` 上/左 · `second` 下/右	2 选 1	second
split_pip_ratio	PIP 那半占的比例。`0.40`=PIP 占 40%、主视频 60%	0.20 – 0.50	0.40
↓ 通用(任意 layout)
main_framing	主视频二次取景(裁切/推拉),对象 `{offset_x, offset_y, zoom}` 或 `null`。offset 是平移比例(`-0.10`=上移10%),zoom 是缩放倍数(`1.15`=放大15%)	offset −1~1 zoom 0.3~3.2	null(不裁)
pip_framing	PIP 视频二次取景,字段同上	同上	null
main_volume	主视频音量。`1.0`=原声,`0.3`=降到30%,`0`=静音	0.0 – 1.0	1.0
pip_volume	PIP 音量,同上	0.0 – 1.0	1.0
pip_cutout	抠像:把 PIP 人物背景去掉做透明叠加(PIP 要是带 alpha 的 webm)	true/false	false
stroke	浮窗/人物描边,对象 `{enabled, color, width_px}` 或 `null`。color 填颜色名(`white`)或 `#RRGGBB`	width 2–40 px	null;扣像时默认白 6px,显式描边默认白 12px

# 照着填的真实示例

默认圆形浮窗

// 啥都不填 = 圆形PIP/右上/占34%/距边2%/音量100% { "main_video_url": "…/main.mp4", "pip_video_url": "…/dh.mp4" }

自定义位置横矩形

{ "overlay_position": "custom", "overlay_x": 0.05, // 左边5% "overlay_y": 0.70, // 上边70%(偏下) "overlay_size": 0.40, "overlay_shape": "hrect", "main_volume": 0.3 }

扣像 + 白描边

{ "layout": "overlay", "overlay_position": "br", "overlay_size": 0.42, "pip_cutout": true, "stroke": {"enabled": true, "color": "white", "width_px": 12} }

上下分屏

{ "layout": "split_v", "split_pip_side": "second", // 数字人在下 "split_pip_ratio": 0.40, // 占40%高 "pip_framing": {"offset_x": 0, "offset_y": -0.10, "zoom": 1.15} }

② subtitle_burn_in — 独立烧字幕

把字幕烧进一个视频。比 combo 那条「裸」:走的是 --override-* 老接口,没有 caption_style 预设 / caption_position / 词级 line-groups 那些新契约。

# 必填

参数	能填什么
video_url	要烧字幕的视频 URL	必填
user_brief	自然语言说明	必填

# 字幕来源(下面挑一个给)

参数	能填什么	优先级
complete_ass_url	完整 ASS 字幕文件 URL(已带样式,直接烧)	最高
srt_url	SRT 字幕 URL(纯文本时序,样式由 burn 给)	次之
ass_style_sample_url	ASS 样式样本 URL(只取样式,套到字幕上)	配合用

# 微调(override,可选,都不填就用 burn 默认)

参数	能填什么	格式	默认
override_fontsize	强制字号(覆盖自动算的起点字号)	整数(像素)	不填=自动
override_marginv	强制底边距 = 字幕离画面底部的距离,越大越往上	整数(像素)	不填=自动
override_primary_color	强制字体主色。必须 `#RRGGBB` 十六进制(如 `#FFD400` 黄、`#FFFFFF` 白),填错格式直接报错	#RRGGBB	不填=预设色

# 示例

// 拿 SRT 烧,字号 64,黄字,底边距 90px { "video_url": "https://cdn-tobatsu/.../video.mp4", "user_brief": "烧黄色字幕,字大一点", "srt_url": "https://cdn-tobatsu/.../subs.srt", "override_fontsize": 64, "override_marginv": 90, "override_primary_color": "#FFD400" }