> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Can I edit an existing image's background? Is the field image_urls?

> Edit an image background on gpt-image-2.5-flare-std by passing 1–16 public HTTPS URLs in the images field on POST /v1/images/tasks, not image_urls.

Yes. Background editing on `gpt-image-2.5-flare-std` uses the `images` array field on `POST /v1/images/tasks` with 1–16 publicly reachable HTTPS image URLs. The parameter name is `images`, not `image_urls`; unknown fields return `400 bad_request`.

## Pass hosted URLs or upload local files

* **Public image URL**: Put the reachable HTTPS URL directly into `images` and describe both the background change and the elements to preserve in `prompt`.
* **Local image file**: Upload PNG, JPG/JPEG, or WebP files (up to 50 MB) through `POST /v1/files`, then pass the returned `data.url` inside `images`.

```bash
curl -sS -X POST 'https://api.beatapi.io/v1/images/tasks' \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare-std",
    "prompt": "Change the tabletop to light gray. Keep the bottle text, label placement and cap color.",
    "images": ["https://example.com/product-photo.png"]
  }'
```

## Billing and output review

* **Token billing and quality**: `gpt-image-2.5-flare-std` runs asynchronously and bills actual text-input, image-input, and output tokens. The optional `quality` field (`low`, `medium`, `high`, `xhigh`, `max`; default `medium`) controls output token volume and cost. Check current rates on [BeatAPI pricing](https://beatapi.io/pricing).
* **Visual verification**: Compare the rendered image side by side with the source photo to confirm label text, brand colors, and product edges before publishing.

## Contracts and related questions

Before sending a paid request, inspect the model contracts for free: `model:gpt-6-luna`, `model:gpt-image-2.5-flare-std`.

[Back to AI Models questions](/faq/models).