InstantID 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    "instantid",
 9    prompt="photo of a man",
10    face_image="https://segmind-sd-models.s3.amazonaws.com/outputs/instantid_input.jpg",
11    negative_prompt="lowquality, badquality, sketches",
12    style="Vibrant Color",
13    samples=1,
14    num_inference_steps=10,
15    guidance_scale=5,
16    seed=354849415,
17    identity_strength=0.8,
18    adapter_strength=0.8,
19    enhance_face_region=True,
20    base64=False,
21)
22print(result["status"])                      # COMPLETED
23print(result.get("output"))                  # model output (e.g. media URL)
24print(result["metrics"]["inference_time"])   # server compute seconds
25
26# --- Or submit + poll manually (track request_id, control the cadence) ---
27from segmind import SegmindClient, InferenceFailed, InferenceTimeout
28
29client = SegmindClient()                      # reads SEGMIND_API_KEY
30payload = {
31    "prompt": "photo of a man",
32    "face_image": "https://segmind-sd-models.s3.amazonaws.com/outputs/instantid_input.jpg",
33    "negative_prompt": "lowquality, badquality, sketches",
34    "style": "Vibrant Color",
35    "samples": 1,
36    "num_inference_steps": 10,
37    "guidance_scale": 5,
38    "seed": 354849415,
39    "identity_strength": 0.8,
40    "adapter_strength": 0.8,
41    "enhance_face_region": True,
42    "base64": False,
43}
44job = client.submit_async("instantid", **payload)
45print(job.request_id)                         # available immediately
46try:
47    result = job.wait(timeout=600, interval=1.0)
48except InferenceTimeout as e:
49    print("still running:", e.request_id)
50except InferenceFailed as e:
51    print("failed:", e.detail)