PineRouterDocs
GuidesModelsAPI referenceApps

Ideogram · v3 Edit

Image model, from $0.022 per image.

Imageideogram/v3-edit

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

Price

SettingsPrice
image to image, turbo$0.022 per image
balanced, image to image$0.044 per image
image to image, quality$0.063 per image

Input fields

FieldType or optionsDefault
promptstring
image_urlstring
mask_urlstring
rendering_speedTURBO BALANCED QUALITY"BALANCED"
expand_promptbooleantrue
seedinteger

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-edit","input":{"rendering_speed":"BALANCED","expand_prompt":true,"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-edit","input":{"rendering_speed":"BALANCED","expand_prompt":True,"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"))