{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-CN/reference/ai_video_object_removal.yaml","sidebar":"sidebar-@l10n/zh-CN/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-CN/reference/ai_video_object_removal.yaml","settings":{"baseUrlPath":"/zh-cn/reference/ai_video_object_removal"},"disableAutoScroll":true,"seo":{"title":"AI 视频对象移除","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 视频对象移除","version":"","description":"# 概览\n\n**AI 视频对象移除**\n\n![](https://plugins-media.makeupar.com/smb/blog/post/2025-02-04/webp_537ec670-48c0-49fc-b96b-8073de21a64b.webp)\n\nAI 视频对象移除接口可以把视频里多余的东西干净移除。不管是挤满游客的背景、桌上堆满纸巾水瓶的杂乱环境，还是玻璃上的反光干扰，这个接口都能把蒙版标出的区域精准、稳定地消除掉，效果前后一致。\n\n\n---\n\n## 接入指南\n\n**1. 准备源视频与蒙版图片**\n输入视频时长不超过 60 秒；输出视频长轴不超过 1920 像素，帧率不超过每秒 30 帧。\n\n\n**2. 上传文件**\n通过以下接口取得上传 URL 与文件 ID：\n\n```\nPOST /s2s/v2.0/file\n```\n\n输入视频：\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_input_edd43a2470.png)\n\n\n参考蒙版：\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_mask_4a1c9fb658.png)\n\n\n**3. 执行 AI 任务**\n\n```\nPOST /s2s/v2.0/task/obj-rem-vid\n```\n\n用文件 ID 或图片 URL 作为输入提交任务。响应会返回一个 task_id，用于追踪并取回结果。\n\n\n**4. 取回任务结果**\n\n```\nGET /s2s/v2.0/task/obj-rem-vid/{task_id}\n```\n\n用任务 ID 追踪状态并取得结果。\n\n可配置 [Webhooks](/develop/webhook.md)，在任务完成（状态为 success 或 error）时接收异步通知。也支持轮询：反复调用任务接口，直到状态从 running 变为 success 或 error。\n\n只有任务成功完成才计费。\n\n\n输出视频示例：\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_output_eb7670cd9e.png)\n\n\n---\n\n## 文件规格与错误码\n\n* 支持的格式与尺寸\n\n|AI 功能|支持尺寸|支持文件大小|支持格式|\n| ---- | ---- | ---- | ---- |\n| AI 视频对象移除 | 输入视频时长不超过 60 秒；输出视频长轴不超过 1920 像素，帧率不超过每秒 30 帧。 | 时长上限：60 秒 | 封装格式：mov、mp4
视频编码：MPEG-4、MPEG-4 AVC，
音频编码：aac、amr、mp3 |\n\n* 错误码\n\n|错误码|说明|\n| ---- | ---- |\n| error_download_video | 下载源视频出错 |\n| error_decode_video | 解码源视频出错 |\n| error_unsupported_video | 视频格式不受支持 |\n| exceed_max_filesize | 输入文件大小超出上限|\n| error_nsfw_content_detected | 在源文件中检测到不适宜内容（NSFW） |\n| error_decode_mask | 解码蒙版图片出错 |\n| invalid_parameter | 参数取值无效|\n\n* 运行环境与依赖\n\n| 示例代码语言 / 工具 | 建议运行时版本 |\n|---|---|\n| cURL | - bash >= 3.2
- curl >= 7.58 (modern TLS/HTTP support)
- jq >= 1.6 (robust JSON parsing) |\n| Node.js (JavaScript) | Node >= 18 (for global fetch) |\n| JavaScript | - Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1 |\n| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |\n| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |\n\n---\n\n## 点数消耗\n\n| AI 功能 | 消耗点数 |\n|---|---|\n| AI 视频对象移除 V2.1 | 2（每秒）* |\n\n > *若图片数量或视频时长不能整除，点数按向上取整计算。\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.199"},"lang":"zh-CN","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-cn/reference/ai_video_object_removal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}