Text to image

POST/higgsfield-ai/soul/v2/standard

Submit a text-to-image task. Save the returned request_id to check its status and retrieve images.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*Prompt

Describe the image to generate or the changes to make to the reference image.

resolution?Resolution

Output resolution tier.

Default"720p"

Value in

"720p"
"1080p"

aspect_ratio?AspectRatio

Aspect ratio of the output image.

Default"4:3"

Value in

"9:16"
"16:9"
"4:3"
"3:4"
"1:1"
"2:3"
"3:2"

batch_size?integer

Number of images to generate per request.

Default1

Value in

Response Body

`application/json`

curl -X POST "https://example.com/higgsfield-ai/soul/v2/standard" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Photograph a bouquet of white tulips on a wooden table by a window, using soft natural light.",
    "resolution": "720p",
    "aspect_ratio": "1:1",
    "batch_size": 1
  }'

{
  "request_id": "REQUEST_ID",
  "status": "queued",
  "expires_after": 604800
}

After receiving request_id, use Get task to check its status and retrieve the image URL.

Higgsfield Soul 2 Text to imageRequest parameters of the native API.

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`