POST https://api.higgsfield.ai/higgsfield-ai/soul/cinema
Endpoint ID: higgsfield-ai/soul/cinema
Open API PlaygroundSOUL Cinema · Text to image↗
Usage notes
- batch_size is 1 or 4 only. A custom_reference_id must belong to the calling account and have completed training.
- aspect_ratio defaults to 1:1 and enhance_prompt defaults to false. seed defaults to a random integer from 1 to 1000000; explicit null is invalid.
- Providing a custom_reference_id enables prompt enhancement for the character reference, even if enhance_prompt is false.
- Cinema uses a fixed style; client-supplied style_id is ignored.
- This model may be absent from model discovery; authorized requests can use the endpoint ID directly.
Quick start
Input schema
Output width-to-height ratio.
Allowed values:
"9:16", "16:9", "4:3", "3:4", "1:1", "2:3", "3:2".Enable prompt enhancement. Providing custom_reference_id enables enhancement even when this field is false.
Identifier of a completed character reference owned by your account.
Format:
uuid.
Omit this field to use the server default; null is accepted only when included in the field type.Complete JSON schema
Complete JSON schema
Response
Submission returns a request handle. Pollstatus_url until status is completed, or use webhooks.
Accepted