---
title: "Vehicle Background Removal API (upload / base64 / custom background)"
method: POST
path: "/v2/remove-background"
tags: ["Images"]
---

# Vehicle Background Removal API (upload / base64 / custom background)

`POST /v2/remove-background`

## Request

- Base URL: `https://images.vinaudit.com`
- URL: `https://images.vinaudit.com/v2/remove-background`
- Auth: API key in query parameter `key`
- TypeScript: <https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/docs/v2/remove-background/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- BackgroundRemovalRequest: Provide one source image -- image_url, image_base64 or image_file.
  - `image_url` string, uri
  - `image_base64` string, byte
  - `background` 'white_background' | 'transparent_background' | 'custom_background' | 'generative_background'
  - `background_url` string, uri
  - `layout` 'center' | 'crop' | 'none'
  - `effect` 'shadow' | 'none'
  - `background_prompt` string
  - `background_negative_prompt` string
  - `plate_replacement` 'image' | 'none'
  - `plate_base64` string, byte: Replacement plate image; required if plate_replacement=image.

## Response `200`

Processed image result

- object
  - `output_url` string, uri: URL of the processed image
  - `error` string: invalid_input, unauthorized_request, no_data, request_failed, or blank.
  - `error_description` string

---

[API](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis.md) - [All operations](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/revisions/1f1500e74b46?raw)