Soul (Text-to-Image)

POST

/higgsfield/v1/text2image/soul

Image source: higgsfield.ai

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

Request

Header Params

Body Params application/json

Example

{
    "params": {
        "quality": "720p",
        "prompt": "a dog",
        "enhance_prompt": true,
        "seed": 38459,
        "style_id": "7696fd45-6e67-47d7-b800-096ce21cd449",
        "negative_prompt": "",
        "width_and_height": "1152x2048",
        "batch_size": 1
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/higgsfield/v1/text2image/soul' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "params": {
        "quality": "720p",
        "prompt": "a dog",
        "enhance_prompt": true,
        "seed": 38459,
        "style_id": "7696fd45-6e67-47d7-b800-096ce21cd449",
        "negative_prompt": "",
        "width_and_height": "1152x2048",
        "batch_size": 1
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "created_at": "2025-12-18T09:42:45.182074Z",
    "id": "higgsfield_0cd796d43340",
    "input_params": {
        "custom_reference": null,
        "custom_reference_strength": 1,
        "enhance_prompt": true,
        "height": 2048,
        "image_reference": null,
        "prompt": "a dog",
        "seed": 38459,
        "style_id": "7696fd45-6e67-47d7-b800-096ce21cd449",
        "style_strength": 1,
        "width": 1152
    },
    "jobs": [
        {
            "id": "higgsfield_0cd796d43340",
            "job_set_type": "text2image_soul",
            "results": null,
            "status": "queued"
        }
    ],
    "type": "text2image_soul"
}

Modified at 2025-12-19 02:59:09

Create Image Generation Request

Fetch (Get task results)