Regenerate Flexible Creative Background
regenerate_flexible_backgroundGenerate a new AI background for a layered creative, optionally using the current background as a reference. Returns a hosted URL for a standalone background image that the caller can download or use independently. The tool does not modify the document or attach the image to an ad; the first-party editor can use the returned URL to replace its background. Existing text and logo layers are unchanged. The supplied aspect_ratio determines the new image shape. Registered brand characters shown in the source are kept unless characters is passed to change them; a result that loses one is returned as an error.
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": {
"domain": "<domain>",
"instructions": "<instructions>"
},
"name": "regenerate_flexible_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Company domain for brand DNA (e.g. 'metadata.io'). No protocol. | |
| platform | No | The creative's channel (its document's `channel`); without aspect_ratio it also picks the shape, the channel's default. Default: 'linkedin'. | |
| characters | No | The brand characters the new background must show. Omit to keep the ones image_source shows; for a fresh scene pass the creative's provenance.quality.characters. [] drops them all. | |
| aspect_ratio | No | Pass the creative's own canvas.aspect_ratio so the new background keeps its shape. Omitted, the channel's default shape is used (the one a new creative takes), which reshapes a creative made in another shape so its layers no longer fit. On a channel's canvas the new background comes back at that canvas's exact size. | |
| image_source | No | Optional URL of the current background to guide a same-style regeneration (image-to-image). Omit for a fresh scene. | |
| instructions | Yes | Direction for the new background scene. | |
| background_hex | No | Optional 6-digit hex to pin the dominant background color (e.g. '#0A2540'). |