Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Higgsfield / Ads Studio

Ads Studio 1.0

Produces advertising images from a brief, reference images and audience, language and niche settings.

availableClosed-source managed componentImage generation
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
10 of 24 specification fields collected
Output resolution2kSee specification notes below
Reference imagesUp to 10 HTTP(S) image URLs; each 1–8192 characters.See specification notes below
Input billingSee ratesHiggsfield API
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Maximum input tokens
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Maximum output
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Reasoning
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Tool calling
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Structured output
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Streaming
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Batch processing
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Fine-tuning
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Knowledge cutoff
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Release date
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Parameters
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Architecture
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Languages
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Context caching
SupportedSource for Context caching (opens in a new tab)

Published cached-input billing; cache mechanics and eligibility remain unverified.

Maximum prompt characters
8,000Source for Maximum prompt characters (opens in a new tab)

Required non-whitespace prompt.

Images per request
8Source for Images per request (opens in a new tab)

batch_size 1–8, default 1; not a discounted Batch API.

Aspect ratios
View all 14 entries
  • 1:1
  • 4:5
  • 5:4
  • 16:9
  • 9:16
  • 4:3
  • 3:4
  • 21:9
  • 3:2
  • 2:3
  • 2:1
  • 1:2
  • 3:1
  • 1:3
Source for Aspect ratios (opens in a new tab)

Default 1:1. Detailed docs add 3:1 and 1:3, absent from the captured console schema; account/runtime support not tested.

Reference images
Up to 10 HTTP(S) image URLs; each 1–8192 characters.Source for Reference images (opens in a new tab)
Campaign brief limits
Optional niche up to 1000 characters, language up to 80 and target_audience up to 2000.Source for Campaign brief limits (opens in a new tab)
Declared backend
GPT Image 2.5 Flare; fixed high quality and 2k rendering after automatic concept preparation.Source for Declared backend (opens in a new tab)
Output resolutions
2kSource for Output resolutions (opens in a new tab)

Fixed rendering tier, not a request control. Exact dimensions vary with aspect ratio.

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

API model ID
higgsfield/ads-studio/v1.0
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)

The introductory blog advertises 20 concurrent requests after key creation. This is not assumed to be every account or model limit.

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)

Generation submissions only. Replays are not new generations and are not prompt caching; no expiry interval is established.

Pricing coverage
USD 0.084/image is explicitly an illustrative estimate, not a fixed tariff or ceiling. Final batch price sums actual image charges; do not multiply aggregate tokens by batch_size again. Concept preparation has no separate charge.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)

Generic documentation describes credits; current model pages publish USD rates. No fixed credit-to-dollar exchange is inferred.

API endpoint URL
POST https://api.higgsfield.ai/higgsfield/ads-studio/v1.0Source for API endpoint URL (opens in a new tab)
Configuration discrepancy
The detailed model guide specifies Key credentials; the console API body shows a generic Bearer SDK example. Detailed docs also include 3:1 and 1:3 aspect ratios absent from the console schema.Source for Configuration discrepancy (opens in a new tab)
Response metadata
One handle for the batch. Read every returned image with its zero-based index and inspect errors for unsuccessful slots.Source for Response metadata (opens in a new tab)
Controls not exposed
quality, resolution, renderer and fallback model are fixed internally; aspect_ratio=auto is not supported.Source for Controls not exposed (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Modality token pricingText input1$5.001M text input tokens
CachingCached text input1$1.251M cached text input tokens
Modality token pricingText output1$10.001M text output tokens
Modality token pricingImage input1$8.001M image input tokens
CachingCached image input1$2.001M cached image input tokens
Modality token pricingImage output1$30.001M image output tokens

Rate conditions

  1. Initial charge is an estimate, reconciled with actual token usage at completion and standard credit rounding. Media workflow, not a general text-question quote.
Pricing source (opens in a new tab)

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)

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

Higgsfield API

higgsfield/ads-studio/v1.0
Documented

Published cached text/image input tariffs. Technical eligibility and actual cache hits were not tested.

Support evidence (opens in a new tab)
How it works
Not collected

Provider publishes cache billing, but cache mechanism is not documented here.

Minimum reusable input
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Lifetime & refresh
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

How to enable it
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Usage fields
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Billing rules
Cached text input USD 1.25/1M tokens; cached image input USD 2/1M tokens.Source for Billing rules (opens in a new tab)
Limits & data boundaries
Not collected

Minimum prefix length, cache lifetime and cross-request eligibility are not established by this pricing description.

Cache reads, writes & storage
ChargeApplies toRate / unit
Cached text input1Caching$1.25 / 1M cached text input tokensPricing evidence (opens in a new tab)
Cached image input1Caching$2.00 / 1M cached image input tokensPricing evidence (opens in a new tab)

Rate conditions

  1. Initial charge is an estimate, reconciled with actual token usage at completion and standard credit rounding. Media workflow, not a general text-question quote.

Observed 15 Oct 2026. Write rates and storage fees are different charges; use the billing rules above.

Caching reviewed 15 Oct 2026

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

Documented hosted creative workflow with a named API contract. The sources do not establish a separately released proprietary foundation checkpoint or its exact upstream model identity; it is counted as a managed component, not a new private base model.

Classification evidence (opens in a new tab)

Sources reviewed