Refine custom background
refine_backgroundAdjust a custom background that already exists and render a new preview, e.g. after create_background when the preview is close but not right. description is only the change to make ('make the floor darker and the lighting warmer'); everything else in the scene is kept, and reference_image_urls can show the look to move towards. The background is updated in place under the same id and name, so later generate_background calls use the refined scene; photos already generated are not changed. Works on custom backgrounds only, not built-in ones; to start a different scene use create_background. Returns the new preview image. Costs one credit; a rejected or failed request is not charged.
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": {
"background_id": "<background_id>",
"description": "<description>"
},
"name": "refine_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | What to change. | |
| background_id | Yes | The `id` of a custom background. | |
| reference_image_urls | No |