Skip to main content
POST
/
v1
/
generation
/
video-background-remove
Submit Video Background Remove Task
curl --request POST \
  --url https://api.weryai.com/v1/generation/video-background-remove \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://example.com/video.mp4",
  "background_color": "BLACK",
  "output_container_and_codec": "MP4_H264"
}
'
{
  "status": 0,
  "desc": "success",
  "message": "success",
  "data": {
    "task_id": "task_abc123",
    "task_status": "waiting"
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate using Bearer token. Get your API Key from the WeryAI Console.

Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Body

application/json
​
video_url
string
required

Source video URL

Example:

"https://example.com/video.mp4"

​
background_color
string
default:BLACK

Background color to fill after removal. Supported values: TRANSPARENT, BLACK, WHITE, GRAY, RED, GREEN, BLUE, YELLOW, CYAN, MAGENTA, ORANGE.

Example:

"BLACK"

​
output_container_and_codec
string
default:MP4_H264

Output container and codec. Supported values: MP4_H265, MP4_H264, WEBM_VP9, MOV_H265, MOV_PRORESKS, MKV_H265, MKV_H264, MKV_VP9, GIF.

Example:

"MP4_H264"

​
caller_id
integer<int64>

Caller ID (for business association)

Response

Task submitted successfully

​
status
integer

Business status code (0 indicates success)

Example:

0

​
desc
string

Status description

Example:

"success"

​
message
string

Multi-language message

Example:

"success"

​
data
object