Ideogram V4.6 Image Editing API

ideogram-ai/ideogram-v4.6/edit

Ideogram V4.6 Image Edit supports written editing instructions, reference images, optional masks and precision controls for product visuals, recoloring and creative variations. Available through the WaveSpeed REST API.

Image Editing
Input

Drag & drop or click to upload

preview

Drag & drop or click to upload

Idle

Change the main title from:
“THE LAST TRAIN”
to:
“THE FINAL PLATFORM”
Change the release date from:
“DECEMBER 12”
to:
“JANUARY 16”
Change the weather to a snowy day.
Preserve all other text exactly as it is.
Keep the woman, her face, red coat, street, rain, lighting, colors, poster layout, typography style, and composition exactly the same.

$0.06per run·~16 / $1

ExamplesView all

Change the main title from:
“THE LAST TRAIN”
to:
“THE FINAL PLATFORM”
Change the release date from:
“DECEMBER 12”
to:
“JANUARY 16”
Change the weather to a snowy day.
Preserve all other text exactly as it is.
Keep the woman, her face, red coat, street, rain, lighting, colors, poster layout, typography style, and composition exactly the same.

Change the main title from: “THE LAST TRAIN” to: “THE FINAL PLATFORM” Change the release date from: “DECEMBER 12” to: “JANUARY 16” Change the weather to a snowy day. Preserve all other text exactly as it is. Keep the woman, her face, red coat, street, rain, lighting, colors, poster layout, typography style, and composition exactly the same.

Turn the sunset into a starry night sky with green northern lights, keep the lighthouse and all the text exactly as they are

Turn the sunset into a starry night sky with green northern lights, keep the lighthouse and all the text exactly as they are

Change her outfit into a fitted ivory winter coat with a charcoal turtleneck and subtle silver earrings.
Preserve the woman’s exact face, hairstyle, body proportions, pose, hand position, and camera framing.
Replace the city terrace with an elegant alpine hotel balcony overlooking snow-covered mountains at golden hour.
Match the new warm winter sunlight naturally across her face, hair, and clothing.
Keep her identity completely recognizable and preserve the original photographic realism.

Change her outfit into a fitted ivory winter coat with a charcoal turtleneck and subtle silver earrings. Preserve the woman’s exact face, hairstyle, body proportions, pose, hand position, and camera framing. Replace the city terrace with an elegant alpine hotel balcony overlooking snow-covered mountains at golden hour. Match the new warm winter sunlight naturally across her face, hair, and clothing. Keep her identity completely recognizable and preserve the original photographic realism.

Related Models

README

Ideogram V4.6 Edit

Ideogram V4.6 Edit changes an existing image from a written instruction, with optional reference images and a mask. Use it to explore product variations, recoloring and campaign visuals.

Why Choose This?

  • Prompt-based editing — Change objects, colors, materials, text and layout with natural language.
  • Reference images — Up to four supporting images guide subjects, products or style.
  • Masked edits — Use a mask to guide a local edit.
  • High precision — Use edit_precision=high for focused edits. See Notes for output-size behavior.
  • Resolution options — Choose 1k, 2k or 4k; output dimensions depend on the editing mode.

Parameters

ParameterRequiredDescription
imageYesPublic URL of the source image.
promptYesThe edit to make (1–10000 characters).
reference_imagesNoUp to 4 guidance images, or 3 with mask_url.
mask_urlNoOptional mask for a local edit. Use the same dimensions as the source image.
aspect_ratioNo1:1, 4:3, 3:4, 3:2, 2:3, 16:9 or 9:16. For regular edits without a mask, omit it to follow the source aspect ratio. Ignored with a mask or high precision.
resolutionNo1k, 2k or 4k. Default: 1k. For mask-based or high-precision edits, see Notes.
edit_precisionNoregular or high. Default: regular.
qualityNovery_low, low, medium or high. Default: medium. very_low is available up to 2k.

Pricing

Quality1k / 2k4k
very_low$0.008—
low$0.03$0.06
medium$0.06$0.20
high$0.22$0.60

A default edit (1k, medium) costs $0.06 per image. Billing follows the selected quality and resolution tiers. Reference images, the mask and edit_precision do not add a separate fee.

Best Use Cases

  • Product variations — New colors, materials and finishes on the same product.
  • Brand recoloring — Explore campaign color palettes.
  • Selective fixes — Repair or replace one area with a mask.
  • Character variations — Use reference images to guide character appearance in new scenes.

Pro Tips

  • Say what should change and what must stay the same.
  • Use a mask or edit_precision=high for focused edits, then review the result for unintended changes.
  • Keep reference images closely related to the change you want.

Notes

  • very_low quality supports 1k and 2k; choose low, medium or high for 4k.
  • Supply up to four reference images without a mask, or up to three when using mask_url. The source image is separate from these references.
  • With mask_url or edit_precision=high, output dimensions follow the source rather than aspect_ratio. Larger images may be resized; selecting 4k does not enlarge a smaller source to 4K. The selected quality and resolution tiers still determine the price.
  • For very wide or tall source images, select a listed aspect_ratio when using regular editing without a mask.
  • Review generated text, colors, subject details and areas outside the intended edit before using the result.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Ideogram v4.6 Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6/edit with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Ideogram v4.6 Edit below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "edit_precision": "regular",
    "quality": "medium"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6/edit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6/edit";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "resolution": "1k",
        "edit_precision": "regular",
        "quality": "medium"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "edit_precision": "regular",
    "quality": "medium"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6/edit", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Ideogram v4.6 Edit API — Frequently asked questions

What is the Ideogram v4.6 Edit API?

Ideogram v4.6 Edit is a Ideogram model for image editing, exposed as a REST API on WaveSpeedAI. Ideogram V4.6 Image Edit supports written editing instructions, reference images, optional masks and precision controls for product visuals, recoloring and creative variations. Available through the WaveSpeed REST API. You can call it programmatically or try it from the playground above.

How do I call the Ideogram v4.6 Edit API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-v4.6/edit.

How much does Ideogram v4.6 Edit cost per run or per second?

Ideogram v4.6 Edit starts at $0.06 per run or per second. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ideogram v4.6 Edit accept?

Key inputs: `prompt`, `image`, `aspect_ratio`, `resolution`, `reference_images`, `edit_precision`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-v4.6/edit.

How do I get started with the Ideogram v4.6 Edit API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Ideogram v4.6 Edit outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Ideogram). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txt — ideogram-ai/ideogram-v4.6/edit for AI agents and LLMs