文生图

POST/higgsfield-ai/soul/v2/standard

提交文生图任务。保存返回的 request_id，用于查询状态和获取图片。

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*Prompt

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

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"

batch_size?integer

每次生成的图片张数。

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": "拍摄窗边木桌上的一束白色郁金香，使用柔和自然光。",
    "resolution": "720p",
    "aspect_ratio": "1:1",
    "batch_size": 1
  }'

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

拿到 request_id 后，在查询任务中查询状态并获取图片 URL。

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

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`