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.
Idle
/filters:quality(85)/examples/4005c12cb263239b8aadd90685b4c5e0/2cf4b2c9-b4aa-4c0a-a0ad-a95a12753adc-f6e3fc1056f2.webp)
$0.06per run·~16 / $1
/filters:quality(82)/examples/4005c12cb263239b8aadd90685b4c5e0/2cf4b2c9-b4aa-4c0a-a0ad-a95a12753adc-f6e3fc1056f2.webp)
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.
/filters:quality(82)/examples/9569a33cf59c13cd68559b31b1d2e829/ea983295-3612-4bb9-a811-8627215f54e3-1322207009ce.webp)
Turn the sunset into a starry night sky with green northern lights, keep the lighthouse and all the text exactly as they are
/filters:quality(82)/examples/85205cdeeb97b0fc09931e5548353bb2/65e5dca0-0f8f-44c9-a81b-643dd9dc1099-88f37171b1cb.webp)
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.
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.
edit_precision=high for focused edits. See Notes for output-size behavior.1k, 2k or 4k; output dimensions depend on the editing mode.| Parameter | Required | Description |
|---|---|---|
| image | Yes | Public URL of the source image. |
| prompt | Yes | The edit to make (1–10000 characters). |
| reference_images | No | Up to 4 guidance images, or 3 with mask_url. |
| mask_url | No | Optional mask for a local edit. Use the same dimensions as the source image. |
| aspect_ratio | No | 1: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. |
| resolution | No | 1k, 2k or 4k. Default: 1k. For mask-based or high-precision edits, see Notes. |
| edit_precision | No | regular or high. Default: regular. |
| quality | No | very_low, low, medium or high. Default: medium. very_low is available up to 2k. |
| Quality | 1k / 2k | 4k |
|---|---|---|
| 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.
edit_precision=high for focused edits, then review the result for unintended changes.very_low quality supports 1k and 2k; choose low, medium or high for 4k.mask_url. The source image is separate from these references.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.aspect_ratio when using regular editing without a mask.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.
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
doneconst 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));
}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 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.
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.
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.
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.
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.
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.