Image to image

Submit a Soul 2 image-to-image task using a public reference image and a prompt.

POST/higgsfield-ai/soul/v2/image-to-image

Submit a reference image and editing instructions. 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.

image_url*string

Publicly accessible reference image URL. You can use images[].url returned by a completed text-to-image task.

Formaturi

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"

Response Body

`application/json`

curl -X POST "https://example.com/higgsfield-ai/soul/v2/image-to-image" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Change the white tulips to pale purple while preserving the wooden table, window light, and composition.",
    "image_url": "https://example.com/tulips.jpg",
    "resolution": "720p",
    "aspect_ratio": "1:1"
  }'

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

You can put images[].url returned by a text-to-image task into image_url. Use the request_id returned by this submission in Get task to retrieve the result.

Higgsfield Soul 2 Image to imageReference image and request 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`