---
title: "Vehicle Background Removal API (image URL)"
method: GET
path: "/v2/remove-background"
tags: ["Images"]
---

# Vehicle Background Removal API (image URL)

`GET /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/get.ts> (a function with typed inputs; its response is checked against the schema)

AI background removal/replacement for exterior and interior vehicle photos. Use GET for simple image URL requests; use POST for uploads, base64 input and custom backgrounds.

## Query parameters

- `image_url` string, uri, required
- `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'

## 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)
