Marketing Studio Image — 2.5 Sunburst API

← Marketing Studio Image Endpoint: POST https://api.higgsfield.ai/marketing-studio/image/sunburst Endpoint ID: marketing-studio/image/sunburst ▶Open API PlaygroundMarketing Studio Image · 2.5 Sunburst↗

Usage notes

Omit image_urls for text-to-image; provide up to 16 URLs for editing when enhance_prompt=false.
enhance_prompt=true requires an existing preset_id and 1–2 image URLs: product first, optional person/model reference second. Discover presets with GET /marketing-studio/image/presets.
Reference images must be valid JPEG, PNG, or WebP. Oversized supported images are normalized before rendering.
With enhancement enabled, aspect_ratio=auto uses the preset ratio. With enhancement disabled, current production mappings use square output for auto.
The 1k/2k/4k values are resolution tiers; exact pixel dimensions depend on the aspect ratio.
quality accepts low, medium, high, xhigh, max and remains selectable with enhancement enabled.

Quick start

curl --request POST \
  --url https://api.higgsfield.ai/marketing-studio/image/sunburst \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
  "prompt": "A ceramic vase on a wooden table beside a sunlit window, soft natural shadows, editorial photograph.",
  "resolution": "2k",
  "aspect_ratio": "1:1",
  "quality": "high",
  "enhance_prompt": false
}'

import higgsfield_client

arguments = (
    {'prompt': 'A ceramic vase on a wooden table beside a sunlit window, soft '
               'natural shadows, editorial photograph.',
     'resolution': '2k',
     'aspect_ratio': '1:1',
     'quality': 'high',
     'enhance_prompt': False}
)
result = higgsfield_client.subscribe(
    "marketing-studio/image/sunburst",
    arguments=arguments,
)
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/sunburst", {
  input:
    {
      "prompt": "A ceramic vase on a wooden table beside a sunlit window, soft natural shadows, editorial photograph.",
      "resolution": "2k",
      "aspect_ratio": "1:1",
      "quality": "high",
      "enhance_prompt": false
    },
  withPolling: true,
});

if (result.status === "completed") {
  console.log(result.images?.[0]?.url);
}

Input schema

string

required

Write your prompt here Minimum characters: 1. Maximum characters: 5000.

string

default:"high"

Allowed values: "low", "medium", "high", "xhigh", "max".

string

Identifier of a Marketing Studio image preset. Format: uuid.

array

Ordered public image reference URLs. Minimum items: 0. Maximum items: 16. Each item: string. Format: uri.

string

default:"auto"

Allowed values: "auto", "low".

string

default:"2k"

Output resolution tier. Allowed values: "1k", "2k", "4k".

string

default:"auto"

Output width-to-height ratio. Allowed values: "auto", "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9".

boolean

default:"false"

Enable prompt enhancement for this workflow.

Complete JSON schema

{
  "type": "object",
  "allOf": [
    {
      "if": {
        "required": [
          "enhance_prompt"
        ],
        "properties": {
          "enhance_prompt": {
            "const": true
          }
        }
      },
      "then": {
        "required": [
          "preset_id",
          "image_urls"
        ],
        "properties": {
          "image_urls": {
            "maxItems": 2,
            "minItems": 1
          }
        }
      }
    }
  ],
  "title": "Marketing Studio Image 2.5 Sunburst",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "maxLength": 5000,
      "minLength": 1,
      "description": "Write your prompt here"
    },
    "quality": {
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "title": "Quality",
      "default": "high"
    },
    "preset_id": {
      "type": "string",
      "title": "Preset ID",
      "format": "uuid"
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Image URLs",
      "maxItems": 16,
      "minItems": 0
    },
    "moderation": {
      "enum": [
        "auto",
        "low"
      ],
      "type": "string",
      "default": "auto"
    },
    "resolution": {
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "2k"
    },
    "aspect_ratio": {
      "enum": [
        "auto",
        "1:1",
        "3:2",
        "2:3",
        "4:3",
        "3:4",
        "16:9",
        "9:16",
        "21:9"
      ],
      "type": "string",
      "title": "Aspect Ratio",
      "default": "auto"
    },
    "enhance_prompt": {
      "type": "boolean",
      "title": "Enhance prompt",
      "default": false
    }
  },
  "additionalProperties": false
}

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.

Accepted

{
  "status": "queued",
  "request_id": "REQUEST_ID",
  "status_url": "https://api.higgsfield.ai/requests/REQUEST_ID/status",
  "cancel_url": "https://api.higgsfield.ai/requests/REQUEST_ID/cancel"
}

A completed response includes the following output fields:

{
  "status": "completed",
  "request_id": "REQUEST_ID",
  "images": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

See idempotent requests, polling, request errors and authentication for shared request handling.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Marketing Studio Image — 2.5 Sunburst API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response