Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Higgsfield / Soul

Soul Cinema

A separate Soul image model with a built-in cinematic aesthetic, color-palette control and reusable character references.

availableClosed weightsImage generation
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
12 of 27 specification fields collected
Output resolution720p, 1080pSee specification notes below
Output formatsNot collectedAwaiting source review
Input billingSee billing notesHiggsfield web application
Output billingSee billing notesAccess and billing notes 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

Not established for this model. Media controls do not establish language-model capabilities.

Maximum input tokens
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Maximum output
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Reasoning
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Tool calling
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Structured output
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Streaming
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Batch processing
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Fine-tuning
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Knowledge cutoff
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Release date
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Parameters
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Architecture
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Languages
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Context caching
Not collected

Not established for this model. Media controls do not establish language-model capabilities.

Input modalities
Text, ImageSource for Input modalities (opens in a new tab)

Web UI accepts a prompt or a reference image; attaching a reference disables the prompt field.

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

API batch_size accepts 1 or 4, default 1.

Image styles
Built-in cinematic aesthetic; no preset or Moodboard panel in the reviewed web guide.Source for Image styles (opens in a new tab)
Style controls
Soul HEX color palette through Color Transfer.Source for Style controls (opens in a new tab)
Character references
Soul ID characters can be reused across the Soul family; the web UI may require a character update.Source for Character references (opens in a new tab)
Published price
Provider introduction advertises from USD 0.0032/image; exact resolution/configuration tariff has not been established.Source for Published price (opens in a new tab)
Output resolutions
720p, 1080pSource for Output resolutions (opens in a new tab)

API default 720p.

Aspect ratios
9:16, 16:9, 4:3, 3:4, 1:1, 2:3, 3:2Source for Aspect ratios (opens in a new tab)

API default 1:1.

Random seed
1–1000000. Omission generates a random seed; explicit null is invalid.Source for Random seed (opens in a new tab)
Prompt expansion
API enhance_prompt defaults to false. A custom_reference_id enables character enhancement even when the flag is false.Source for Prompt expansion (opens in a new tab)

Access & pricing

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

Higgsfield web application

Provider source (opens in a new tab)
API model ID
Not collected

No exact API model selector established for this access path.

Access
Consumer web generation interface; plan credits and available controls are shown in the application. No generation performed.
Regions
Not established
Application URL
https://higgsfield.ai/soul-cinemaSource for Application URL (opens in a new tab)
Reference guidance
Prompt and reference image are mutually exclusive in the reviewed web UI. Soul ID and Soul HEX can still accompany a reference.Source for Reference guidance (opens in a new tab)

Endpoint pricing has not been collected. Check the provider for applicable rates.

Data & enterprise terms

Retention, training use, regional processing and enterprise terms have not been summarized for this endpoint.

API model ID
higgsfield-ai/soul/cinema
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
Provider introduction advertises from USD 0.0032/image; exact resolution/configuration tariff has not been established.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-ai/soul/cinemaSource for API endpoint URL (opens in a new tab)
Input modalities
TextSource for Input modalities (opens in a new tab)

The documented API accepts a prompt and optional trained identity UUID; no raw scene image field is exposed. Web controls have a separate contract.

Prompt expansion
API enhance_prompt defaults to false. A custom_reference_id enables character enhancement even when the flag is false.Source for Prompt expansion (opens in a new tab)
Model controls
prompt, aspect_ratio, enhance_prompt, resolution, custom_reference_id, custom_reference_strength, seed, batch_sizeSource for Model controls (opens in a new tab)
Image styles
Fixed Cinema style; client style_id is ignored.Source for Image styles (opens in a new tab)
Character references
Completed custom_reference_id owned by the calling account; strength 0–1, default 1. No training-version mapping established here.Source for Character references (opens in a new tab)
Availability
May be absent from model discovery; authorized clients can invoke the endpoint ID directly.Source for Availability (opens in a new tab)

Endpoint pricing has not been collected. Check the provider for applicable rates.

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 web application

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

Higgsfield API

higgsfield-ai/soul/cinema
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

Higgsfield identifies this as its own model and distributes it through its hosted products. Closed-weight classification is inferred from first-party attribution, commercial access and API terms restricting weight extraction; the reviewed sources do not establish a downloadable checkpoint or an open-weight license.

Classification evidence (opens in a new tab)

Sources reviewed