Higgsfield API
Provider source (opens in a new tab)- API model ID
marketing-studio/image- Access
- Documented hosted generation route; workspace credentials, API balance and model access required. No generation submitted.
- Regions
- Not established
- Authentication
- Authorization: Key KEY_ID:KEY_SECRET; JSON requests from a server-side application.Source for Authentication (opens in a new tab)
- Processing workflow
- Asynchronous submission returns request_id and status_url. Poll for completed images; only queued work can be canceled.Source for Processing workflow (opens in a new tab)
- Request quotas
- Account- and model-specific concurrency, counting queued and processing requests. Dashboard limits are authoritative; current guide describes HTTP 400 on saturation and no standard rate-limit or Retry-After headers.Source for Request quotas (opens in a new tab)
- Safe request retries
- Optional Idempotency-Key: 1–255 visible ASCII characters without whitespace. Same account, endpoint, body and webhook reuse the original request ID; mismatches return 422. Read status_url for current state.Source for Safe request retries (opens in a new tab)
- Pricing coverage
- Published USD model tariffs; authenticated /estimate/{model-path} gives a configuration quote. Example credits/usd values in shared documentation are illustrative, not this model’s rate.Source for Pricing coverage (opens in a new tab)
- Billing basis
- Separate prepaid API balance; consumer subscriptions do not fund API use. Failed, moderated and successfully canceled queued generations are refunded.Source for Billing basis (opens in a new tab)
- API endpoint URL
- POST https://api.higgsfield.ai/marketing-studio/imageSource for API endpoint URL (opens in a new tab)
- Application name
- Marketing Studio Image 2.0 AlphaSource for Application name (opens in a new tab)
- Maximum prompt characters
- 5,000Source for Maximum prompt characters (opens in a new tab)
- Aspect ratios
- auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9Source for Aspect ratios (opens in a new tab)
- Reference guidance
- Direct generation omits image_urls; editing accepts up to 16. Enhanced mode requires preset_id plus one product image and optionally one model image.Source for Reference guidance (opens in a new tab)
- Preset catalog
- GET /marketing-studio/image/presets?size=50 returns visible usable Ads presets. Follow cursor pagination and use the selected current UUID; preset IDs are not a fixed enum.Source for Preset catalog (opens in a new tab)
- Preset enhancement billing
- enhance_prompt=true adds 10% and requires high quality.Source for Preset enhancement billing (opens in a new tab)
- Declared backend
- Not collected
- Input file formats
- JPEG, PNG, WebPSource for Input file formats (opens in a new tab)
- Output dimension controls
- Direct auto uses square output in current production mappings; enhanced auto follows the preset. Resolution tiers do not independently specify exact pixel dimensions.Source for Output dimension controls (opens in a new tab)
The introductory blog advertises 20 concurrent requests after key creation. This is not assumed to be every account or model limit.
Generation submissions only. Replays are not new generations and are not prompt caching; no expiry interval is established.
Generic documentation describes credits; current model pages publish USD rates. No fixed credit-to-dollar exchange is inferred.
Required prompt: 1–5000 characters. Host-specific limit, not the native provider limit.
Default auto; enhanced auto follows the selected preset.
The high-quality requirement is explicit in the public conditional schema.
Exact upstream model identity not established. Do not infer GPT Image 2 from the variant label.
Oversized supported images are normalized before rendering; exact byte ceiling not collected.
Prices retain their published currencies and billing units below.
| Category | Usage | Rate | Unit |
|---|---|---|---|
| Promotional media pricing | 1k low · 15% off1 | $0.0138 | image |
| Standard media pricing | 1k low · standard2 | $0.0162 | image |
| Promotional media pricing | 2k low · 15% off1 | $0.0189 | image |
| Standard media pricing | 2k low · standard2 | $0.0222 | image |
| Promotional media pricing | 4k high · 15% off1 | $0.6136 | image |
| Standard media pricing | 4k high · standard2 | $0.7219 | image |
Rate conditions
- Published promotional price, auto aspect ratio. Only this exact quality/resolution combination; promotion expiry and account eligibility not established. Enhanced mode has an additional 10% charge.
- Published standard price, auto aspect ratio. Enhanced mode adds 10% and requires high quality. Other aspect/quality combinations need a separate quote.
Data & enterprise terms
API content may be used for training unless the workspace opts out; processing can take 10 business days and is prospective. Enterprise agreements can differ. Request records remain while the account is active; generated files are available for at least seven days. Zero retention requires an eligible enterprise addendum. Partner/excluded-model policies can differ.
Read the service policy (opens in a new tab)