Soul (Text to Image)

POST

/higgsfield/text2image_soul

Text-to-image from higgsfield.ai
Each call generates 4 images, supporting multiple templates (style_id) and custom aspect ratios (aspect_ratio).
Supports "feature consistency" image generation: upload an image via the Character (Generate Features) interface to obtain feature values (custom_reference_id) and set feature strength (custom_reference_strength).
After submitting the task, obtain the "id" and go to the Fetch (Get Task Result) interface to query the result.

Price: basic 0.1 PTC / time
Price: high 0.2 PTC / time

Request

Header Params

Body Params application/json

Example

{
    "quality": "high",
    "aspect_ratio": "16:9",
    "prompt": "a dog",
    "enhance_prompt": true,
    "seed": 38459,
    "style_id": "7696fd45-6e67-47d7-b800-096ce21cd449",
    "negative_prompt": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/higgsfield/text2image_soul' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "quality": "high",
    "aspect_ratio": "16:9",
    "prompt": "a dog",
    "enhance_prompt": true,
    "seed": 38459,
    "style_id": "7696fd45-6e67-47d7-b800-096ce21cd449",
    "negative_prompt": ""
}'

Responses

🟢200成功

application/json

Body

Example

{
    "board_ids": [],
    "id": "higgsfield_472f8f0319ac",
    "result": null,
    "results": null,
    "status": "queued"
}

Modified at 2025-07-21 06:48:40

Create Image Generation Request

Character (Generate Character)