PoYo Video Background Removal

PoYo Links

• Model page: https://poyo.ai/models/video-background-removal
• API key page: https://poyo.ai/dashboard/api-key

Use this skill for poyo-ai/video-background-removal jobs on PoYo. It helps agents prepare video cutout payloads, submit async tasks, and explain safe server-side integration.

Use When

• The user explicitly wants to use PoYo with poyo-ai/video-background-removal, video background removal, transparent video cutouts, hosted video compositing, or the PoYo async media utility API.
• The user asks for a PoYo video-background-removal request payload, server-side curl command, integration notes, status polling, webhook setup, or response parsing.
• The user has already chosen PoYo as the execution provider for a video background-removal workflow.

Model Selection

• poyo-ai/video-background-removal: use for removing the background from an existing hosted video file.

Key Inputs

• video_url is required and must point to a publicly accessible video file.
• output_container_and_codec is optional; use it when a downstream editor or delivery surface requires a specific output.
• preserve_audio is optional; set it based on whether the source audio should remain in the output.
• background_color is optional; use Transparent for transparent compositing when the selected output format supports it.
• callback_url is optional and useful for production queues.

Security Rules

• Treat POYO_API_KEY as a secret.
• Keep PoYo API keys in server-side environment variables or a backend secret manager.
• Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.
• Do not log private source video URLs, generated outputs, callback URLs, task ids, or raw authorization headers unless the product policy allows it.
• Do not use this skill for generic video editing unless the user explicitly wants a PoYo video background-removal API workflow.
• Do not make live API calls unless the user explicitly asks, confirms the payload should be sent to PoYo, and provides a safe server-side environment.

Execution

• Read references/api.md for endpoint details, request fields, examples, and result retrieval notes.
• Use scripts/submit_video_background_removal.sh only when the user wants to submit a prepared JSON payload from a trusted shell.
• If the user only needs a curl example, adapt one from references/api.md.
• After submission, report the returned task_id clearly so follow-up polling is easy.

Output Expectations

When helping with PoYo Video Background Removal, include:

• chosen model id
• source video URL handling notes
• output container or codec choice when relevant
• whether audio should be preserved
• transparent or solid background setting when relevant
• final payload or concise parameter summary
• returned task_id if a request was actually submitted
• next step: poll status or wait for webhook