视频画中画 API · 按处理量

把一个视频或图片以画中画方式叠加到主视频上，可设位置、大小、出现时间。适合加 logo、解说小窗、画中画。

入参

字段	类型	必填	说明
`video`	`string · uri`	是	主视频（底层）（公网可访问的文件 URL）
`subvideo_url`	`string · uri`	是	叠加素材（视频/图片）（公网可访问的文件 URL）
`pos_x`	`number`	否	水平位置 X（像素）；距左边像素，默认 0（默认 0）
`pos_y`	`number`	否	垂直位置 Y（像素）；距顶部像素，默认 0（默认 0）
`width`	`number`	否	叠加宽度（像素）；默认 320（默认 320）
`height`	`number`	否	叠加高度（像素）；默认 180（默认 180）
`start_time`	`number`	否	出现时间（秒）；从第几秒出现，默认 0（默认 0）

出参

字段	类型	说明
`out`	`string`	结果文件链接（.mp4）

怎么调用

在 Agent 里说（Claude Code / Cursor / 豆包工作 / WorkBuddy，先 set up https://apibobo.com/SKILL.md）：

用波波 API 的「视频画中画」处理这个文件：https://…

命令行（npm i -g @apibobo-ai/cli）：

bobo run -p video -e /pip -i '{"video":"https://example.com/file.pdf","subvideo_url":"https://example.com/file.pdf","pos_x":0,"pos_y":0,"width":320,"height":180,"start_time":0}'

REST：

curl -X POST https://apibobo.com/v1/tools/run \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"video","endpoint":"/pip","input":{"video":"https://example.com/file.pdf","subvideo_url":"https://example.com/file.pdf","pos_x":0,"pos_y":0,"width":320,"height":180,"start_time":0}}'

先 inspect 看完整 schema 再 run，别猜参数。

价格与健康度

价格：按处理量（调用前无法预估，以 run 返回的 usage 为准）
失败（非 2xx）不扣费

常见问题

怎么计费？

按处理量（时长 / 大小）折算，调用前无法精确预估，以 run 返回的 usage / cost 为准。没有月费。

调用失败会扣费吗？

不会。只有返回 2xx 的成功调用才扣费；上游报错、帖子不存在、参数错误都不扣。

文件怎么传？

传公网可访问的 URL，不接受本地路径和 base64。结果也是 URL，有效期内可直接下载。

在飞书多维表格里能用吗？

能。同一个 Key 在多维表格的字段捷径里也能用，选一列点一下，整列出结果。见 https://apibobo.com/shortcuts。

入参

出参

怎么调用

价格与健康度

常见问题

同类工具