Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Higgsfield / Soul

Soul ID

Trains and manages reusable character references for Soul image generation. Returns a reference ID and processing status rather than a new foundation model.

availableClosed-source managed componentImage processing
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
6 of 21 specification fields collected
Image input limitNot collectedAwaiting source review
Output typesReference ID, Reference mediaSee 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

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.

Output modalities
Reference ID, Reference mediaSource for Output modalities (opens in a new tab)
Reference image limits
1–100 input images as image_url objects.Source for Reference image limits (opens in a new tab)
Reference name limit
Required name, maximum 100 characters.Source for Reference name limit (opens in a new tab)
Processing versions
Default v1; explicitly request model_version=v2 for Soul 2.Source for Processing versions (opens in a new tab)

Standalone Soul ID parameter table omits model_version; the Soul 2 integration guide supplies the field.

Custom model training
Asynchronous character-reference training; use the completed UUID in a compatible Soul generation. No downloadable weights or arbitrary base-model training interface established.Source for Custom model training (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.

API model ID
Not collected

No exact API model selector established for this access path.

Access
Managed identity-reference service; account credentials, applicable likeness consent and protected-feature verification required. No training submitted.
Regions
Not established
API endpoint URL
POST https://api.higgsfield.ai/v1/custom-referencesSource for API endpoint URL (opens in a new tab)
Authentication
Reference schema requires hf-api-key (UUID), lists hf-secret as optional, and examples send both. Soul 2 integration uses Authorization: Key KEY_ID:KEY_SECRET for the same reference paths.Source for Authentication (opens in a new tab)

Authentication documentation differs; no request was sent to verify interchangeability.

Processing workflow
Creation returns id; poll GET /v1/custom-references/{reference_id}. States: not_ready, queued, in_progress, completed, failed.Source for Processing workflow (opens in a new tab)
Reference management
GET /v1/custom-references/list supports page=1 and page_size=20 defaults. DELETE /v1/custom-references/{reference_id} returns 204. The UUID is a reference ID, not a generation request ID.Source for Reference management (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Media generationSoul ID training request1$2.50request

Rate conditions

  1. Related-model catalog lists Soul ID at USD 2.50/request. This is not a fee for each subsequent generated image or each GET/DELETE call; version-specific price differences are not published in the reviewed table.
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

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

The provider documents custom-reference training and management as a hosted service. A reference ID is not a separately released foundation model or a downloadable checkpoint.

Classification evidence (opens in a new tab)

Sources reviewed