Graphic ads

Marketing Studio Image 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. 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. aspect_ratio supports auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, and 21:9. Enhanced requests cost 10% more than the equivalent direct request.

4. Authentication and queue

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