Higgsfield Soul 2.0 Serverless API

 1# pip install "segmind>=1.1.0"
 2# export SEGMIND_API_KEY="YOUR_API_KEY"
 3import segmind
 4
 5# Async (v2): submit to the queue and block until COMPLETED.
 6# run() returns the final result dict (600s deadline, 1.0s poll by default).
 7result = segmind.run(
 8    "higgsfield-soul-2",
 9    prompt="Editorial fashion portrait of a woman with auburn wavy hair and freckles, cinematic golden-hour window light, soft film grain, high-end magazine aesthetic, cream cashmere sweater, shallow depth of field, shot on 85mm",
10    aspect_ratio="3:4",
11    resolution="1080p",
12    image_url="https://segmind-resources.s3.amazonaws.com/input/higgsfield-soul-2-input-reference.jpg",
13    seed=123456,
14)
15print(result["status"])                      # COMPLETED
16print(result.get("output"))                  # model output (e.g. media URL)
17print(result["metrics"]["inference_time"])   # server compute seconds
18
19# --- Or submit + poll manually (track request_id, control the cadence) ---
20from segmind import SegmindClient, InferenceFailed, InferenceTimeout
21
22client = SegmindClient()                      # reads SEGMIND_API_KEY
23payload = {
24    "prompt": "Editorial fashion portrait of a woman with auburn wavy hair and freckles, cinematic golden-hour window light, soft film grain, high-end magazine aesthetic, cream cashmere sweater, shallow depth of field, shot on 85mm",
25    "aspect_ratio": "3:4",
26    "resolution": "1080p",
27    "image_url": "https://segmind-resources.s3.amazonaws.com/input/higgsfield-soul-2-input-reference.jpg",
28    "seed": 123456,
29}
30job = client.submit_async("higgsfield-soul-2", **payload)
31print(job.request_id)                         # available immediately
32try:
33    result = job.wait(timeout=600, interval=1.0)
34except InferenceTimeout as e:
35    print("still running:", e.request_id)
36except InferenceFailed as e:
37    print("failed:", e.detail)