ナビゲーションにスキップ

Can I edit an existing image’s background? Is the field 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.
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.
  • Visual verification: Compare the rendered image side by side with the source photo to confirm label text, brand colors, and product edges before publishing.

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.