models/Ideogram/Ideogram V2 Edit

Ideogram V2 Edit

image

Transform existing images with Ideogram V2's editing capabilities. Modify, adjust, and refine images while maintaining high fidelity and realistic outputs with precise prompt control.

Ideogram V2 Edit (ideogram/ideogram-v2-edit) is a image model from Ideogram. Pricing via AIgateway: $0.080 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="ideogram/ideogram-v2-edit". Best for: Marketing assets, Product mockups, Concept art.

slug · ideogram/ideogram-v2-editprovider · Ideogram

Use this model

model: ideogram/ideogram-v2-edit

curl https://api.aigateway.sh/v1/images/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ideogram/ideogram-v2-edit","prompt":"a serene cyberpunk city at dusk"}'

curl https://api.aigateway.sh/v1/images/generations \ -H "Authorization: Bearer $AIGATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"ideogram/ideogram-v2-edit","prompt":"a cyberpunk cat"}'

Capabilities

Strengths

Text-to-image generation
Creative control

Use cases

Marketing assetsProduct mockupsConcept art

Pricing

Per image$0.080

You pay pass-through · 5% applied at credit top-up, not per-call.

Try in playground →Compare API reference See usage ranking →

Collections

More image models →More from Ideogram →Frontier models →Free-tier models →

API schema

Call Ideogram V2 Edit from any OpenAI SDK

POST https://api.aigateway.sh/v1/images/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json

{
  "model": "ideogram/ideogram-v2-edit",
  "prompt": "A cyberpunk cat at sunset, cinematic lighting",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"   // or "b64_json"
}

Response

json

{
  "created": 1776947082,
  "data": [
    { "url": "https://media.aigateway.sh/img/abc123.png" }
    // or { "b64_json": "iVBORw0KGgoAAAANSUhEU..." }
  ]
}

Quickstart

from openai import OpenAI
client = OpenAI(base_url="https://api.aigateway.sh/v1", api_key="sk-aig-...")

r = client.images.generate(
    model="ideogram/ideogram-v2-edit",
    prompt="a cyberpunk cat at sunset",
    size="1024x1024",
)
print(r.data[0].url)

Errors

401authentication_errorInvalid or missing API key

402insufficient_creditsWallet empty (PAYG only)

404not_foundUnknown model or endpoint

429rate_limit_errorOver per-minute limit — see Retry-After header

500server_errorUpstream provider failed (retryable)

503service_unavailableUpstream saturated (retryable)

Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Ideogram V2 Edit?

Transform existing images with Ideogram V2's editing capabilities. Modify, adjust, and refine images while maintaining high fidelity and realistic outputs with precise prompt control. It is a image model from Ideogram, accessible via AIgateway's OpenAI-compatible API at slug ideogram/ideogram-v2-edit.

How much does Ideogram V2 Edit cost via AIgateway?

$0.0800 per image. Pass-through plus a 5% platform fee applied at top-up.

How do I call Ideogram V2 Edit from my code?

Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "ideogram/ideogram-v2-edit". The request and response shapes match OpenAI exactly.

Does Ideogram V2 Edit support streaming, tool calling, vision, and JSON mode?

Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.

What are the best use cases for Ideogram V2 Edit?

Marketing assets, Product mockups, Concept art. Key strengths: Text-to-image generation; Creative control.

Can I bring my own Ideogram API key (BYOK)?

Yes. Attach a Ideogram key in your AIgateway dashboard and this model flips to pass-through — you pay Ideogram directly and AIgateway waives the 5% platform fee on those calls.