FFmpeg 媒体处理 · FFmpeg 媒体
FFmpeg 媒体处理 · 介绍NEW
FFmpeg 媒体处理 API：转码、压缩、缩放、裁剪、抽帧、水印、拼接、合流、提取音频、转 GIF、缩略图、媒体探测，以及文件上传。 调用流程：① 用 upload 上传文件拿到 CDN URL → ② 调用对应操作（输入用该 URL）→ ③ 按 taskId 轮询结果直到 succeeded / failed。 输入仅接受平台 CDN 白名单域名的 URL。按积分付费，提交预扣、失败自动退回。
怎么调用
- 上传：
POST /v1/ffmpeg/upload（multipart），拿到 CDN URL。 - 提交：
POST /v1/ffmpeg/{operation}，输入用上一步的 URL，返回 taskId。 - 查询：
GET /v1/ffmpeg/info?id=taskId，轮询到 status = succeeded。
能力地图
POST文件上传upload
上传媒体文件（multipart），同步直传并返回 CDN URL。
POST媒体探测probe
提取媒体元信息：时长 / 分辨率 / 码率 / 编码。瞬时完成。
POST转码 / 格式转换transcode
转换容器格式与音视频编码。
POST压缩降体积compress
降低视频体积。
POST分辨率缩放scale
把视频缩放到目标分辨率。
POST裁剪片段trim
截取视频的一段时间区间。
POST提取音频extract_audio
从视频中分离出音频文件。
POST视频转 GIFto_gif
把视频片段转成 GIF 动图。
POST截取缩略图thumbnail
在指定时间点截取一帧图片。
POST叠加水印watermark
在视频上叠加图片水印。
POST拼接视频concat
把多个视频按顺序拼接成一个。
POST视频音频合流mux
把音频合并进视频（替换或追加音轨）。
POST批量抽帧frames
按间隔或帧率批量导出图片帧。
计费说明
提交预扣、失败自动退回。计费公式：积分 = max(1, ceil(输出时长秒 × 0.05 × 操作系数 × 分辨率系数))。upload / probe / thumbnail 固定 1 积分。
分辨率系数：480P=0.6，720P=1.0，1080P=1.8，>1080P=3.0。最终积分乘以你的用户费率。
并发与限制
- 单用户同时运行任务上限：3
- 单任务超时：300 秒（超时判失败并退款）
- 上传上限 200MB；任务输入下载上限 1GB
- 输入 URL 仅支持平台 CDN 白名单域名
常见错误
| 错误码 | msg | 含义 | 处理建议 |
|---|---|---|---|
| 400 | invalid params / non-allowlist url | 参数非法或输入 URL 非白名单域名（扣费前拒绝） | 检查枚举取值/范围；输入先用 upload 上传获取 CDN URL |
| 429 | Task limit reached | 同时运行任务超过 3 个上限 | 等待已有任务完成后再提交 |
| 500 | failed / timeout | 处理失败或超时（300 秒），积分已自动退回，详见 data.errorMsg | 按 errorMsg 调整输入/参数后重试 |