Ideogram 4.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    "ideogram-4",
 9    prompt="A vintage-style travel poster of Tokyo at night, glowing neon signs reflecting on wet streets, a bold title reading \"TOKYO\" across the top and the tagline \"Where Tradition Meets Tomorrow\" below, vibrant teal and magenta palette, clean retro print design",
10    rendering_speed="QUALITY",
11    image_size="square_hd",
12    num_images=1,
13    enable_prompt_expansion=True,
14    output_format="jpeg",
15    seed=123456,
16    enable_safety_checker=True,
17)
18print(result["status"])                      # COMPLETED
19print(result.get("output"))                  # model output (e.g. media URL)
20print(result["metrics"]["inference_time"])   # server compute seconds
21
22# --- Or submit + poll manually (track request_id, control the cadence) ---
23from segmind import SegmindClient, InferenceFailed, InferenceTimeout
24
25client = SegmindClient()                      # reads SEGMIND_API_KEY
26payload = {
27    "prompt": "A vintage-style travel poster of Tokyo at night, glowing neon signs reflecting on wet streets, a bold title reading \"TOKYO\" across the top and the tagline \"Where Tradition Meets Tomorrow\" below, vibrant teal and magenta palette, clean retro print design",
28    "rendering_speed": "QUALITY",
29    "image_size": "square_hd",
30    "num_images": 1,
31    "enable_prompt_expansion": True,
32    "output_format": "jpeg",
33    "seed": 123456,
34    "enable_safety_checker": True,
35}
36job = client.submit_async("ideogram-4", **payload)
37print(job.request_id)                         # available immediately
38try:
39    result = job.wait(timeout=600, interval=1.0)
40except InferenceTimeout as e:
41    print("still running:", e.request_id)
42except InferenceFailed as e:
43    print("failed:", e.detail)