PoYo 视频背景移除

PoYo 相关链接

• 模型页面：https://poyo.ai/models/video-background-removal
• API 密钥页面：https://poyo.ai/dashboard/api-key

本技能用于在 PoYo 上执行 poyo-ai/video-background-removal 类型的任务。它可协助智能体构建视频抠图请求载荷、提交异步任务，并说明服务端安全集成方式。

适用场景

• 用户明确希望使用 PoYo 的 poyo-ai/video-background-removal 模型，或提及“视频背景移除”、“透明视频抠图”、“托管式视频合成”、“PoYo 异步媒体工具 API”等关键词。
• 用户请求生成 PoYo 视频背景移除的请求载荷、服务端 curl 命令、集成注意事项、状态轮询方法、Webhook 配置方式，或响应解析说明。
• 用户已选定 PoYo 作为视频背景移除工作流的执行服务提供商。

模型选择

• poyo-ai/video-background-removal：适用于对已托管的视频文件执行背景移除操作。

关键输入参数

• video_url 为必填项，且必须指向一个公开可访问的视频文件。
• output_container_and_codec 为可选项；当下游编辑器或交付终端对输出格式有特定要求时使用。
• preserve_audio 为可选项；根据是否需保留源视频音频来设置该参数。
• background_color 为可选项；当所选输出格式支持透明通道时，请设为 Transparent 以启用透明合成。
• callback_url 为可选项，适用于生产环境中的任务队列管理。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，严格保密。
• PoYo API 密钥应仅存储于服务端环境变量或后端密钥管理服务中。
• 严禁将 API 密钥嵌入浏览器端代码、前端构建产物、公开代码仓库、日志、截图或聊天输出中。
• 除非产品策略明确允许，否则不得记录私有源视频 URL、生成的输出地址、回调 URL、任务 ID 或原始认证请求头等敏感信息。
• 除非用户明确要求基于 PoYo 的视频背景移除 API 工作流，否则不得将本技能用于通用视频编辑场景。
• 除非用户明确要求发起调用、确认载荷将发送至 PoYo 并提供安全的服务端运行环境，否则不得执行实时 API 请求。

执行方式

• 查阅 references/api.md 获取接口端点详情、请求字段定义、示例及结果获取说明。
• 仅当用户明确希望从可信 Shell 环境中提交已准备好的 JSON 载荷时，才使用 scripts/submit_video_background_removal.sh 脚本。
• 若用户仅需 curl 示例命令，请直接参考并适配 references/api.md 中提供的样例。
• 提交成功后，请清晰返回 task_id，以便后续状态轮询操作顺利进行。

输出预期

在协助用户完成 PoYo 视频背景移除任务时，输出内容应包含以下要素：

• 所选模型 ID
• 源视频 URL 的处理说明（如访问权限、格式兼容性等）
• 相关情况下所选的输出容器或编码格式
• 是否保留音频的明确说明
• 相关情况下关于透明背景或纯色背景的配置说明
• 最终请求载荷，或简明的参数摘要
• 若实际提交了请求，则须返回 task_id
• 下一步操作建议：轮询任务状态，或等待 Webhook 回调