Replace photo background
generate_backgroundReplace the background of one car photo with a chosen scene: the main tool for turning a phone photo into a listing photo. The car is kept as photographed and gets shadows, lighting and reflections that match the scene. Works on exterior, interior and detail shots. Pick background_id with list_backgrounds first and use the same one for every photo of a car. In the same call it can hide the plate (hide_license_plate, with license_plate_style and, for logo, a license_plate_logo from list_logos), draw a dealer logo, reframe to an aspect_ratio, centre the car or show it washed. To hide the plate without changing the background use hide_license_plates; to make a new scene use create_background. One photo per call; the source photo is not modified. Costs one credit, and a failed generation is not charged. Can take up to a minute. Returns a signed image_url of the high-resolution result, valid for 7 days.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_url": "<image_url>",
"background_id": "<background_id>"
},
"name": "generate_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| logo | No | Draw one of the workspace's logos on the result. | |
| clean_car | No | Experimental: show the car freshly washed. | |
| image_url | Yes | Public HTTPS URL of the car photo (JPEG, PNG or WebP). | |
| center_car | No | Experimental: centre, enlarge and level the car like a listing photo. | |
| aspect_ratio | No | Output aspect ratio. Omit to keep the photo's own. | |
| background_id | Yes | A background `id` from list_backgrounds. | |
| hide_license_plate | No | Hide a legible license plate (exterior photos). | |
| license_plate_logo | No | Required with license_plate_style `logo`. | |
| license_plate_style | No | With hide_license_plate: `plain` (default) replaces it with a blank plate, `blur` blurs it, `logo` shows the dealer's plate logo (set license_plate_logo). |