Ideogram 2a Text To Image 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-2a-txt-2-img",
 9    magic_prompt_option="AUTO",
10    prompt="A dreamy, ultra-detailed miniature scene featuring tiny chocolatiers in brown aprons and chef hats, crafting luxurious chocolate treats. Some temper glossy chocolate on a marble slab, while others dip delicate strawberries into molten chocolate fountains. One chef meticulously carves intricate designs into a chocolate bar. The background is a charming chocolate boutique with golden packaging and shelves lined with handcrafted truffles. The rich, warm lighting enhances the decadent and magical atmosphere",
11    resolution="RESOLUTION_1024_1024",
12    seed=56698,
13    style_type="GENERAL",
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    "magic_prompt_option": "AUTO",
25    "prompt": "A dreamy, ultra-detailed miniature scene featuring tiny chocolatiers in brown aprons and chef hats, crafting luxurious chocolate treats. Some temper glossy chocolate on a marble slab, while others dip delicate strawberries into molten chocolate fountains. One chef meticulously carves intricate designs into a chocolate bar. The background is a charming chocolate boutique with golden packaging and shelves lined with handcrafted truffles. The rich, warm lighting enhances the decadent and magical atmosphere",
26    "resolution": "RESOLUTION_1024_1024",
27    "seed": 56698,
28    "style_type": "GENERAL",
29}
30job = client.submit_async("ideogram-2a-txt-2-img", **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)