Ideogram · v3 Text To Image

Imageideogram/v3-text-to-image

Use with POST /v1/jobs, POST /v1/images/generations.

Price

Settings	Price
text to image, turbo	$0.022 per image
balanced, text to image	$0.044 per image
quality, text to image	$0.063 per image

Input fields

Field	Type or options	Default
`prompt`	string
`rendering_speed`	`TURBO` `BALANCED` `QUALITY`
`style`	`AUTO` `GENERAL` `REALISTIC` `DESIGN`
`expand_prompt`	boolean
`image_size`	`square` `square_hd` `portrait_4_3` `portrait_16_9` `landscape_4_3` `landscape_16_9`
`seed`	integer
`negative_prompt`	string

Files are public https links. Safety filters are always on.

Example

curl https://pinerouter.ai/v1/jobs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"ideogram/v3-text-to-image","input":{"prompt":"Describe what you want"}}'

Then poll GET /v1/jobs/<id> until data.status is succeeded (links in data.outputs), or pass webhook_url to be called when it finishes; see Jobs.

import time, requests

BASE, H = "https://pinerouter.ai", {"Authorization": "Bearer YOUR_API_KEY"}
job = requests.post(f"{BASE}/v1/jobs", headers=H, json={"model":"ideogram/v3-text-to-image","input":{"prompt":"Describe what you want"}}).json()["data"]
while job["status"] not in ("succeeded", "failed"):
    time.sleep(5)
    job = requests.get(f"{BASE}/v1/jobs/{job['id']}", headers=H).json()["data"]
print(job["outputs"] or job.get("error"))