Marketing Studio Image

Marketing Studio Image (2.5 Flare) generates and edits campaign images. Set enhance_prompt to true to apply a Marketing Studio preset before rendering.

1. Direct generation or editing

Omit image_urls for generation. Pass one or more image URLs for editing (up to 16). Direct mode is the default.

2. Preset enhancement

Enhanced mode requires a preset and one product image. A second image is treated as the optional model reference. Without a second image, the composition stays product-only; the endpoint does not generate a person automatically.

Get a preset UUID

Before sending an enhanced request, fetch the current visible presets with the same API credentials:

The endpoint returns only visible, usable Ads presets. The response contains { "total": ..., "cursor": ..., "items": [...] }. Let the user select a preset, then copy the selected item's id into the generation request as preset_id:

Do not hardcode preset UUIDs or source them from a static enum: presets are managed in the CMS and can change visibility. If cursor is not null, pass it to the next catalog request to load another page. The preset catalog and preset_id are needed only when enhance_prompt is true.

Send the enhanced request

3. Request behavior

resolution supports 1k, 2k, and 4k; the default is 2k. aspect_ratio supports auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, and 21:9. In enhanced mode, auto uses the selected preset's aspect ratio.

quality supports low, medium, high, xhigh, and max; the default is high. Preset enhancement preserves the selected quality and renders with GPT Image 2.5 Flare.

Direct and enhanced requests use the same token rates, with no separate enhancement surcharge. The initial charge is an estimate reconciled against actual token usage on completion. Prompt length, reference images, resolution, and quality affect the final cost.

4. Authentication and queue

Send POST requests to https://api.higgsfield.ai/marketing-studio/image/flare with Authorization: Key KEY_ID:KEY_SECRET. The endpoint is asynchronous; poll the returned request ID or use a webhook.