视频加字幕 API · 按处理量

把字幕文件（SRT/VTT/ASS）加到视频画面上（硬字幕），可设字号与颜色。可配合「语音转字幕」使用。

入参

字段	类型	必填	说明
`video`	`string · uri`	是	视频（公网可访问的文件 URL）
`subtitle_url`	`string · uri`	是	字幕文件（SRT/VTT/ASS）（公网可访问的文件 URL）
`font_size`	`number`	否	字号；8 ~ 200，默认 24（默认 24）
`font_color`	`string · #FFFFFF \| #000000 \| #FFFF00 \| #FF0000`	否	字体颜色。#FFFFFF=白色 White，#000000=黑色 Black，#FFFF00=黄色 Yellow，#FF0000=红色 Red（默认 "#FFFFFF"）
`pos_x`	`number`	否	字幕框左上角 X（像素）；默认 0（默认 0）
`pos_y`	`number`	否	字幕框左上角 Y（像素）；默认 960（按你的视频高度调整，字幕一般放底部）（默认 960）
`width`	`number`	否	字幕框宽度（像素）；默认 1920（建议=视频宽度）（默认 1920）
`height`	`number`	否	字幕框高度（像素）；默认 120（默认 120）

出参

字段	类型	说明
`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 /add-subtitles -i '{"video":"https://example.com/file.pdf","subtitle_url":"https://example.com/file.pdf","font_size":24,"font_color":"#FFFFFF","pos_x":0,"pos_y":960,"width":1920,"height":120}'

REST：

curl -X POST https://apibobo.com/v1/tools/run \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"video","endpoint":"/add-subtitles","input":{"video":"https://example.com/file.pdf","subtitle_url":"https://example.com/file.pdf","font_size":24,"font_color":"#FFFFFF","pos_x":0,"pos_y":960,"width":1920,"height":120}}'

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

价格与健康度

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

常见问题

怎么计费？

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

调用失败会扣费吗？

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

文件怎么传？

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

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

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

入参

出参

怎么调用

价格与健康度

常见问题

同类工具