models/Ideogram/Ideogram Replace Background

Ideogram Replace Background

image

Replace backgrounds existing images with Ideogram V3's replace background feature. Create variations and adaptations while preserving core elements and adding new creative directions through prompt guidance.

Ideogram Replace Background (ideogram/ideogram-v3-replace-background) is a image model from Ideogram. Pricing via AIgateway: $0.030 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="ideogram/ideogram-v3-replace-background". Best for: Marketing assets, Product mockups, Concept art.

slug · ideogram/ideogram-v3-replace-backgroundprovider · Ideogram

Use this model

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

Capabilities

Strengths

  • Text-to-image generation
  • Creative control

Use cases

Marketing assetsProduct mockupsConcept art

Pricing

Per image$0.030
You pay pass-through · 5% applied at credit top-up, not per-call.
Try in playground →CompareAPI referenceSee usage ranking →

Collections

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

Call Ideogram Replace Background 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-v3-replace-background",
  "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-v3-replace-background",
    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 Replace Background?
Replace backgrounds existing images with Ideogram V3's replace background feature. Create variations and adaptations while preserving core elements and adding new creative directions through prompt guidance. It is a image model from Ideogram, accessible via AIgateway's OpenAI-compatible API at slug ideogram/ideogram-v3-replace-background.
How much does Ideogram Replace Background cost via AIgateway?
$0.0300 per image. Pass-through plus a 5% platform fee applied at top-up.
How do I call Ideogram Replace Background from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "ideogram/ideogram-v3-replace-background". The request and response shapes match OpenAI exactly.
Does Ideogram Replace Background 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 Replace Background?
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.