テキストから画像を生成

Soul 2 のテキストからの画像生成タスクを送信し、タスク ID を取得します。

POST/higgsfield-ai/soul/v2/standard

テキストからの画像生成タスクを送信します。返された request_id を保存し、状態の確認と画像の取得に使用します。

認証

bearerAuth

認証Bearer <token>

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

prompt*Prompt

生成したい画像、または参照画像に加えたい変更を記述します。

resolution?Resolution

出力解像度の設定。

デフォルト値"720p"

指定可能な値

"720p"
"1080p"

aspect_ratio?AspectRatio

出力画像のアスペクト比。

デフォルト値"4:3"

指定可能な値

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

batch_size?integer

リクエストごとに生成する画像の枚数。

デフォルト値1

指定可能な値

レスポンスボディ

`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 テキストから画像を生成ネイティブ API のリクエストパラメータを確認します。

テキストから画像を生成

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`