Ideogram · Character Edit | PineRouter Docs

Imageideogram/character-edit

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

Price

Settings	Price
image to image, turbo	$0.075 per image
balanced, image to image	$0.112 per image
image to image, quality	$0.150 per image

Input fields

Field	Type or options	Default
`prompt`	string
`image_url`	string
`mask_url`	string
`reference_image_urls`	list
`rendering_speed`	`TURBO` `BALANCED` `QUALITY`	`"BALANCED"`
`style`	`AUTO` `REALISTIC` `FICTION`	`"AUTO"`
`expand_prompt`	boolean
`num_images`	`1` `2` `3` `4`	`"1"`
`seed`	integer

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/character-edit","input":{"rendering_speed":"BALANCED","style":"AUTO","num_images":"1","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/character-edit","input":{"rendering_speed":"BALANCED","style":"AUTO","num_images":"1","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"))