Generates and edits images · up to 4 per request
curl -X POST https://api.open.sume.com/v1/image-router/generate \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"ideogram-v3","prompt":"A studio product photo on a white sweep","aspect_ratio":"1:1","quality":"TURBO","num_images":1}'Ideogram V3 has the model id ideogram-v3. Send a JSON body to POST https://api.open.sume.com/v1/image-router/generate.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| model | string | Yes | — | "ideogram-v3" |
| prompt | string | Yes | — | What the image shows. |
| image_urls | string[] | No | — | Images to edit or follow (HTTPS). |
| aspect_ratio | string | No | 1:1 | Frame shape. Options: 1:3, 3:1, 1:2, 2:1, 9:16, 16:9, 10:16, 16:10, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 1:1. |
| quality | string | No | TURBO | Quality tier (sets the price). Options: TURBO, BALANCED, QUALITY. |
| num_images | integer | No | 1 | Images per request, 1–4. |
Send your open.sume.com key as a bearer token from server code only. Keys minted on open.sume.com bill this balance in dollars and call the model API only.
Authorization: Bearer $SUME_API_KEY
A submit answers 202 with the job, its status_url and result_url. Poll the status until it is completed, failed or canceled; failed and canceled jobs are refunded.
Dollars per unit at each option: the serving route's cost × 1.25, rounded up to $0.0001. The estimate above is the exact charge.
| Option | Price |
|---|---|
| TURBO | $0.0750 / image |
| BALANCED | $0.0750 / image |
| QUALITY | $0.0750 / image |
Price, resolution and duration show each model's full range.
| Model | Type | Price | Resolution | Duration |
|---|---|---|---|---|
| Ideogram 4.5 | image | $0.0375 – $0.2750 / image | 1K – 2K | — |
GET https://api.open.sume.com/v1/jobs/<job_id>/status GET https://api.open.sume.com/v1/jobs/<job_id>/result POST https://api.open.sume.com/v1/jobs/<job_id>/cancel
The estimate is the charge: the same function prices both.
curl -X POST https://api.open.sume.com/v1/open/estimate \
-H "Content-Type: application/json" \
-d '{"model":"ideogram-v3","input":{"prompt":"…"}}'Full reference: docs.sume.com