Marketing Studio Image Generate and Edit API

Generate and edit

Endpoint: POST https://api.higgsfield.ai/marketing-studio/image Endpoint ID: marketing-studio/image ▶Try Marketing Studio ImageOpen this endpoint in the Higgsfield API Playground.↗

Quick Start

import higgsfield_client

result = higgsfield_client.subscribe(
    "marketing-studio/image",
    arguments={
        "prompt": "A clean summer launch campaign for a citrus sparkling drink",
        "resolution": "2k",
        "aspect_ratio": "4:3",
        "quality": "high",
    },
)

print(result["images"][0]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe(
  "marketing-studio/image",
  {
    input: {
      prompt: "A clean summer launch campaign for a citrus sparkling drink",
      resolution: "2k",
      aspect_ratio: "4:3",
      quality: "high",
    },
    withPolling: true,
  },
);

if (result.isCompleted) console.log(result.jobs[0].results?.raw.url);

curl --request POST \
  --url https://api.higgsfield.ai/marketing-studio/image \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean summer launch campaign for a citrus sparkling drink",
    "resolution": "2k",
    "aspect_ratio": "4:3",
    "quality": "high"
  }'

Input Schema

string

required

Campaign instructions from 1 to 5,000 characters.

array

Publicly accessible reference image URLs. Direct mode accepts up to 16. Enhanced mode requires one product image and accepts one optional model image, in that order.

string

default:"2k"

Output resolution. Supported values: 1k, 2k, 4k.

string

Supported values: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. If omitted, direct mode uses a square output. In enhanced mode, auto or an omitted value uses the selected preset’s aspect ratio.

string

default:"high"

Supported values: low, medium, high. Enhanced mode always renders at high quality.

string

default:"auto"

Supported values: auto, low.

boolean

default:"false"

Build a preset-guided campaign composition. When true, preset_id and at least one image_urls item are required.

string

UUID returned by the Marketing Studio presets endpoint. Required when enhance_prompt is true.

List Marketing Studio presets

GET https://api.higgsfield.ai/marketing-studio/image/presets Use this endpoint to retrieve valid preset_id values for enhanced requests.

Query parameter	Type	Default	Description
`search`	string	—	Search preset or group names. Accepts 1–100 characters.
`size`	integer	`50`	Results per page. Accepts 1–100.
`cursor`	integer	`0`	Zero-based pagination cursor.

curl --request GET \
  --url "https://api.higgsfield.ai/marketing-studio/image/presets?size=50&cursor=0"

{
  "total": 120,
  "cursor": 50,
  "items": [
    {
      "id": "<preset-uuid>",
      "type": "ads",
      "name": "Editorial product portrait",
      "cover_image": null,
      "metadata": {
        "aspect_ratio": "3:4",
        "group_name": "Editorial"
      },
      "format_slugs": []
    }
  ]
}

The response cursor is null when there are no more results.

Output Schema

string

required

Request state. A newly accepted request returns queued.

string

required

Stable identifier used for polling, cancellation, and support.

string

required

URL to poll until the request reaches a terminal state.

string

required

URL used to cancel a request before processing starts.

array

Completed image outputs. Each item contains a download url.

Input Examples

Replace <preset-uuid> with an id returned by List Marketing Studio presets before submitting the preset-guided example.

{
  "prompt": "A clean summer launch campaign for a citrus sparkling drink",
  "resolution": "2k",
  "aspect_ratio": "4:3",
  "quality": "high"
}

{
  "prompt": "Place the product in a bright poolside campaign scene",
  "image_urls": ["https://cdn.example.com/product.png"],
  "resolution": "2k",
  "aspect_ratio": "3:4",
  "quality": "high"
}

{
  "prompt": "Premium, minimal, warm morning light",
  "image_urls": [
    "https://cdn.example.com/product.png",
    "https://cdn.example.com/model.png"
  ],
  "preset_id": "<preset-uuid>",
  "enhance_prompt": true,
  "resolution": "2k",
  "aspect_ratio": "auto"
}

Output Example

{
  "status": "queued",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "status_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
  "cancel_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
}

{
  "status": "completed",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "images": [{ "url": "https://cdn.example.com/marketing-studio-image.png" }]
}

Use an SDK for automatic polling, or poll the returned status URL.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Marketing Studio Image Generate and Edit API

Quick Start

Input Schema

List Marketing Studio presets

Output Schema

Input Examples

Output Example

​Quick Start

​Input Schema

​List Marketing Studio presets

​Output Schema

​Input Examples

​Output Example

Quick Start

Input Schema

List Marketing Studio presets

Output Schema

Input Examples

Output Example