SOUL Cinema Text to Image API

import higgsfield_client

result = higgsfield_client.subscribe(
    "higgsfield-ai/soul/cinema",
    arguments={
        "prompt": "A lone astronaut crossing a monumental brutalist hall, volumetric light",
        "aspect_ratio": "16:9",
        "resolution": "1080p",
        "enhance_prompt": True,
        "batch_size": 1,
    },
)

print(result["images"][0]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe(
  "higgsfield-ai/soul/cinema",
  {
    input: {
      prompt: "A lone astronaut crossing a monumental brutalist hall, volumetric light",
      aspect_ratio: "16:9",
      resolution: "1080p",
      enhance_prompt: true,
      batch_size: 1,
    },
    withPolling: true,
  },
);

if (result.isCompleted) console.log(result.jobs[0].results?.raw.url);

curl --request POST \
  --url https://api.higgsfield.ai/higgsfield-ai/soul/cinema \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A lone astronaut crossing a monumental brutalist hall, volumetric light",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "enhance_prompt": true,
    "batch_size": 1
  }'

{
  "prompt": "A coastal observatory above a storm, cinematic concept art",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "enhance_prompt": true,
  "batch_size": 1
}

{
  "prompt": "A futuristic couture portrait under a single hard spotlight",
  "aspect_ratio": "3:4",
  "resolution": "1080p",
  "enhance_prompt": true,
  "seed": 481516,
  "batch_size": 4
}

{
  "status": "queued",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "status_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
  "cancel_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
}

{
  "status": "completed",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "images": [{ "url": "https://cdn.example.com/soul-cinema-output.jpg" }]
}