curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "poyo-ai/video-background-removal",
"input": {
"video_url": "https://example.com/dancer.mp4",
"background_color": "Transparent",
"output_container_and_codec": "webm_vp9",
"preserve_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1793176000-example",
"status": "not_started",
"created_time": "2026-10-28T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "validation_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "validation_error"
}
}AI Tools
Video Background Removal
Remove the background from a video and return a transparent or solid-color result.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "poyo-ai/video-background-removal",
"input": {
"video_url": "https://example.com/dancer.mp4",
"background_color": "Transparent",
"output_container_and_codec": "webm_vp9",
"preserve_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1793176000-example",
"status": "not_started",
"created_time": "2026-10-28T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "validation_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "validation_error"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the response result through the unified Query Task Status endpoint.
Models
- poyo-ai/video-background-removal — Remove the background from one video
Required parameters
video_url(string): Source video URL.
Optional parameters
output_container_and_codec(string):mp4_h265,mp4_h264,webm_vp9,mov_h265,mov_proresks,mkv_h265,mkv_h264,mkv_vp9, orgif.preserve_audio(boolean): Whether to keep the source audio track.background_color(string):Transparent,Black,White,Gray,Red,Green,Blue,Yellow,Cyan,Magenta, orOrange. Case-sensitive.
Output
A finished task returns one video infiles with file_type: video, encoded with the requested output_container_and_codec.
Examples
- Transparent background as WebM — sets
video_url,background_color,output_container_and_codec,preserve_audio. - Green screen as MP4 — sets
video_url,background_color,output_container_and_codec.
Notes
- Optional fields that are omitted use the provider defaults.
- For a transparent result, pair
Transparentwith a container that supports an alpha channel, such aswebm_vp9ormov_proresks. - PoYo reads the video duration before submitting. Submission fails if the duration cannot be determined.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json