AI 视频对象移除
AI 视频对象移除
AI 视频对象移除接口可以把视频里多余的东西干净移除。不管是挤满游客的背景、桌上堆满纸巾水瓶的杂乱环境，还是玻璃上的反光干扰，这个接口都能把蒙版标出的区域精准、稳定地消除掉，效果前后一致。
1. 准备源视频与蒙版图片 输入视频时长不超过 60 秒；输出视频长轴不超过 1920 像素，帧率不超过每秒 30 帧。
2. 上传文件 通过以下接口取得上传 URL 与文件 ID：
POST /s2s/v2.0/file输入视频：
参考蒙版：
3. 执行 AI 任务
POST /s2s/v2.0/task/obj-rem-vid用文件 ID 或图片 URL 作为输入提交任务。响应会返回一个 task_id，用于追踪并取回结果。
4. 取回任务结果
GET /s2s/v2.0/task/obj-rem-vid/{task_id}用任务 ID 追踪状态并取得结果。
可配置 Webhooks，在任务完成（状态为 success 或 error）时接收异步通知。也支持轮询：反复调用任务接口，直到状态从 running 变为 success 或 error。
只有任务成功完成才计费。
输出视频示例：
- 支持的格式与尺寸
| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|---|---|---|---|
| AI 视频对象移除 | 输入视频时长不超过 60 秒；输出视频长轴不超过 1920 像素，帧率不超过每秒 30 帧。 | 时长上限：60 秒 | 封装格式：mov、mp4 视频编码：MPEG-4、MPEG-4 AVC， 音频编码：aac、amr、mp3 |
- 错误码
| 错误码 | 说明 |
|---|---|
| error_download_video | 下载源视频出错 |
| error_decode_video | 解码源视频出错 |
| error_unsupported_video | 视频格式不受支持 |
| exceed_max_filesize | 输入文件大小超出上限 |
| error_nsfw_content_detected | 在源文件中检测到不适宜内容（NSFW） |
| error_decode_mask | 解码蒙版图片出错 |
| invalid_parameter | 参数取值无效 |
- 运行环境与依赖
| 示例代码语言 / 工具 | 建议运行时版本 |
|---|---|
| cURL | - bash >= 3.2 - curl >= 7.58 (modern TLS/HTTP support) - jq >= 1.6 (robust JSON parsing) |
| Node.js (JavaScript) | Node >= 18 (for global fetch) |
| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |
| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |
| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |
下载 OpenAPI 描述
语言
服务器
https://yce-api-01.makeupar.com