Bria Video Eraser Serverless API

Effortlessly remove unwanted objects from videos while preserving audio and reconstructing backgrounds seamlessly.

~120.79s
~$0.319
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/bria-erase-video"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "video_url": "https://segmind-resources.s3.amazonaws.com/output/d81ba915-2d92-40e7-8d10-fbe2ac6126cd-bria-eraser-input.mp4",
12    "mask_url": "https://segmind-resources.s3.amazonaws.com/output/96387624-7266-4d13-aa1c-d16497cbfdd9-bria-eraser-nask.mp4",
13    "preserve_audio": true,
14    "auto_trim": false,
15    "output_container_and_codec": "mp4_h264"
16}
17
18response = requests.post(url, headers=headers, json=data)
19
20if response.status_code == 200:
21    result = response.json()
22    print(json.dumps(result, indent=2))
23else:
24    print(f"Error: {response.status_code}")
25    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/bria-erase-video

Parameters

mask_urlrequired
string (uri)

Enter a URL of a mask video to specify areas to erase. Use precise mask for specific regions.

video_urlrequired
string (uri)

Enter a public video URL. Use high-definition video for better erasure results.

auto_trimoptional
boolean

Enable to trim videos over 5 seconds. Useful for quick demos and prototyping.

Default: false
output_container_and_codecoptional
string

Select output format and codec. Use 'webm_vp9' for web compatibility or 'mp4_h265' for high efficiency.

Default: "mp4_h264"
Allowed values :
"mp4_h264""mp4_h265""webm_vp9""mov_h265""mov_proresks""mkv_h264""mkv_h265""mkv_vp9""gif"
preserve_audiooptional
boolean

Choose to keep original audio. Keep enabled for videos where background sound is important.

Default: true

Response Type

Returns: Video

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out