图生图

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

提交参考图和修改要求。保存返回的 request_id，用于查询状态和获取图片。

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*Prompt

描述要生成的图片或希望对参考图做出的修改。

image_url*string

公网可访问的参考图 URL。可使用文生图任务完成后返回的 images[].url。

Formaturi

resolution?Resolution

输出分辨率档位。

Default"720p"

Value in

"720p"
"1080p"

aspect_ratio?AspectRatio

输出图片的宽高比。

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": "把白色郁金香改成淡紫色，保留木桌、窗光和构图。",
    "image_url": "https://example.com/tulips.jpg",
    "resolution": "720p",
    "aspect_ratio": "1:1"
  }'

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

可将文生图任务返回的 images[].url 填入 image_url。用本次提交返回的 request_id 前往查询任务获取结果。

Higgsfield Soul 2 图生图查看原生接口的参考图和请求参数。

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`