API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Ideogram V2 Turbo Edit

ideogram-ai/ideogram-v2/turbo/edit

Ideogram V2 Turbo Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Base price
$0.05USD / run
Execution
async
Model type
image
Input fields
4

Try the model

Playground

Open playground
Input
The prompt to fill the masked part of the image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The image URL to generate an image from. Needs to match the dimensions of the mask.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The mask URL to inpaint the image. Needs to match the dimensions of the input image.
Seed for the random number generator
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.05 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Ideogram
Model ID
ideogram-ai/ideogram-v2/turbo/edit
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Ideogram V2 Turbo Edit

ideogram-ai/ideogram-v2/turbo/edit applies natural-language edits to a supplied image while preserving requested subjects, typography, and unaffected composition. Ideogram's editing workflow combines scene understanding with its typography and design strengths, making it useful for meaningful creative changes rather than only basic retouching. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with ideogram-ai/ideogram-v2/turbo/edit, it suits copy updates, object changes, restyling, background revision, and campaign variations where the source artwork must remain the foundation. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Instruction-led editing changes selected content, style, lighting, or layout from text.

Source preservation retains requested subjects, typography, and unaffected composition.

Typography-aware revision updates designed text while maintaining visual integration.

Turbo iteration accelerates this creative transformation for rapid comparison and high-volume variation.

Pricing

Billing unitPrice
Per request$0.05

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For image-conditioned generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "image": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v2/turbo/edit/input_image_1.jpeg",
  "prompt": "A knight in shining armour holding a greatshield with \"FAL\" on it"
}

Technical Specs

SpecValue
Model IDideogram-ai/ideogram-v2/turbo/edit
Inputsimage, mask, prompt, seed
Required inputsprompt, image
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
ideogram-ai/ideogram-v2/turbo/edit
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "ideogram-ai/ideogram-v2/turbo/edit",
  "mask": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v2/turbo/edit/input_mask_0.jpeg",
  "image": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v2/turbo/edit/input_image_1.jpeg",
  "prompt": "A knight in shining armour holding a greatshield with \"FAL\" on it"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
IdeogramImage$0.05 / runDec 4, 2024
IdeogramImage$0.06 / runMay 1, 2025
IdeogramImage$0.06 / runMay 1, 2025

Questions

FAQ

How do I call Ideogram V2 Turbo Edit through SandBase?

Create a SandBase API key, then send requests with the model ID "ideogram-ai/ideogram-v2/turbo/edit" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Ideogram account?

No. One SandBase API key and balance gives you access to Ideogram V2 Turbo Edit and the other models in the catalog; you do not need to sign up with Ideogram separately.