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.
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.
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/genjutsu/object-swap/v1.0
Not verified
No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.
How it works
Not collected
No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.
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
Not collected
No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.
Limits & data boundaries
Not collected
No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.
No verified cache rate for this endpoint. An empty rate is not a zero charge.
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.
