
De Ideogram 4.6 API is gebouwd voor een workflow die de meeste afbeeldings-API's slecht afhandelen: een poster met exacte woorden genereren en daarna één tekstregel wijzigen zonder de rest opnieuw te tekenen. Deze how-to behandelt beide helften met request bodies: tekst in de afbeelding met ideogram-v4.6, en bewerkingen met hoge precisie, gemaskeerde en lokale bewerkingen met ideogram-v4.6-edit. Alles hier draait tegen het Ideogram 4.6-model op PoYo, en de cijfers komen uit onze test op de launchdag, 20 november 2026.
Deel 1: exacte tekst in de afbeelding met de Ideogram 4.6 API
De PoYo-docs geven één regel voor tekst: zet de exacte tekst voor in de afbeelding tussen aanhalingstekens in de prompt. Beschrijf waar elke regel staat en hoe groot die is, zoals je een ontwerper zou briefen.
Dit is het request uit onze test op de launchdag (taak M4WA9OIQXVV80DHG):
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
"size": "2304x3072",
"quality": "high",
"n": 1
}
}
Het gaf één PNG van 2304×3072 terug van ongeveer 10.8 MB en kostte 40 credits ($0.20), het 4K-high-tarief. Alle drie de geciteerde regels werden weergegeven zoals geschreven, inclusief de kleine cursieve regel. Dezelfde prompt met quality: very_low en size: 3:4 (taak BS7M64COKT80JSLX) gaf een concept van 768×1024 terug voor 1.6 credits ($0.008), ook met correcte tekst maar een andere compositie.
Drie gewoontes maken tekstrequests in productie betrouwbaarder:
| Gewoonte | Waarom |
|---|---|
| Eén geciteerde string per tekstregel | Elke regel is een aparte eenheid die je kunt controleren en later bewerken |
| Geef grootte en positie van elke regel op ("grote kop bovenaan", "een kleinere regel eronder") | De hiërarchie is onderdeel van het request en wordt niet aan het toeval overgelaten |
| Controleer de output vóór publicatie | Ideogram adviseert zelf: "Check spelling and placement in the final result." |
Promptuitbreiding staat bij deze API altijd aan, dus het model kan details toevoegen waar je niet om vroeg. In onze poster voegde het een kleine "EST. 1987" en een webadres toe in de onderste hoeken. Als een lay-out alleen jouw woorden mag bevatten, zeg dat dan in de prompt en controleer het resultaat, of verwijder extra's met een bewerking.
Deel 2: drie manieren om te bewerken met ideogram-v4.6-edit
Elke bewerking neemt precies één bronafbeelding in image_urls en een prompt. De instellingen hieronder bepalen hoeveel van de afbeelding het model mag aanraken. Als je app gebruikers de bron laat uploaden, bespaart een controle vooraf mislukte taken; de gids voor beeldmoderatie laat één manier zien.
| Modus | Instellingen | Wat behouden blijft | Outputformaat |
|---|---|---|---|
| Reguliere bewerking | edit_precision: regular (standaard) | De afbeelding wordt opnieuw gegenereerd vanuit de prompt | auto of elk preset-/aangepast formaat zonder masker |
| Bewerking met hoge precisie | edit_precision: high, context_window: none | Ongewijzigde pixels worden hersteld | Resolutie van de bron |
| Lokale bewerking | edit_precision: high, context_window: auto, mask_url | Elke pixel buiten het gebied rond het masker | Resolutie van de bron |
Ideogram zegt dat 4.6 "leaves far less pixel drift outside your edits", en rapporteert op zijn modelpagina 90% voor gemaskeerde bewerkingen ("change only the painted area") tegenover 82% voor Ideogram 4.5. Dat zijn scores van Ideogram. Dit is wat wij hebben gemeten.
Bewerking met hoge precisie: één tekstregel wijzigen
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
"image_urls": [
"https://example.com/northbound-poster.png"
],
"edit_precision": "high",
"context_window": "none",
"size": "auto",
"quality": "high",
"n": 1
}
}
In onze test (taak 672JRU198S22NS8D) was de bron de poster van 2304×3072 uit deel 1. De output was 2304×3072 met de nieuwe datumregel. Een pixeldiff tegen het origineel plaatste elke gewijzigde pixel binnen één kader, van (471, 2699) tot (1826, 2756): de datumregel, ongeveer 1.1% van de afbeelding. De kop, de illustratie en de kleine cursieve regel bleven ongewijzigd. De afschrijving was 120 credits ($0.60), omdat een bewerking met hoge precisie de resolutie van de bron behoudt en 2304×3072 boven 4,194,304 pixels ligt.
Twee regels om te onthouden: edit_precision: high vereist size: auto (of geen size), en weigert background.
Gemaskeerde bewerking: de wijziging beperken tot één gebied
Een masker neemt het giswerk weg over waar de bewerking plaatsvindt. Het moet dezelfde afmetingen hebben als de bron, zwart zijn waar het model mag bewerken, wit waar het moet behouden, en beide bevatten. Dit Python-fragment maakt er een van een kader:
from PIL import Image, ImageDraw
source = Image.open("poster.png")
mask = Image.new("L", source.size, 255) # white = keep
ImageDraw.Draw(mask).rectangle((440, 2660, 1860, 2800), fill=0) # black = edit
mask.save("date-line-mask.png")
Upload het masker (publieke URL of base64-data-URI) en voeg het toe aan het request:
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the sign text to \"OPEN LATE\"",
"image_urls": [
"https://example.com/storefront.png"
],
"mask_url": "https://example.com/sign-mask.png",
"edit_precision": "high",
"context_window": "auto",
"quality": "high"
}
}
Met context_window: auto wordt alleen het gebied rond het masker bewerkt en blijft de resolutie van de bron behouden. Een masker dat te groot is, valt terug op bewerking van de hele afbeelding. context_window: auto zonder zowel mask_url als edit_precision: high wordt geweigerd, en een masker vereist altijd size: auto. Met een masker kun je tot 3 referentieafbeeldingen toevoegen in reference_image_urls, bijvoorbeeld een logo of een lettertypevoorbeeld.
Deel 3: de bewerking verifiëren in je pipeline
Als je app belooft "alleen de tekst is gewijzigd", controleer dat dan. Dit is hetzelfde soort controle dat wij op de bewerking van de launchdag hebben uitgevoerd:
from PIL import Image, ImageChops
before = Image.open("before.png").convert("RGB")
after = Image.open("after.png").convert("RGB")
assert before.size == after.size, "high-precision edits keep the source size"
diff = ImageChops.difference(before, after).convert("L").point(lambda v: 255 if v > 32 else 0)
box = diff.getbbox()
print("changed box:", box)
if box:
area = (box[2] - box[0]) * (box[3] - box[1])
print(f"box covers {area / (before.width * before.height):.2%} of the image")
Vergelijk het kader met het gebied dat je wilde wijzigen, bijvoorbeeld je masker. Als het daar ver buiten valt, probeer het dan opnieuw met een masker en context_window: auto, of met een strakkere prompt.
Deel 4: bewerkingen in meerdere rondes en kosten
Voor een reeks wijzigingen stuur je elk resultaat terug als volgende bron in image_urls en wijzig je per request één ding. De pagina van Ideogram beschrijft 4.6 als gemaakt om "keep refining the same image across multiple turns". Elke ronde is een aparte taak, afgerekend op outputformaat:
| Bewerking van een bron... | medium | high |
|---|---|---|
| Tot 4,194,304 pixels | 12 credits ($0.06) | 44 credits ($0.22) |
| Boven 4,194,304 pixels | 40 credits ($0.20) | 120 credits ($0.60) |
Drie tekstwijzigingen met high op onze 4K-poster zouden 360 credits ($1.80) kosten; op een versie van 1728×2304 van dezelfde poster zouden het 132 credits ($0.66) zijn. Download elk resultaat: gegenereerde bestanden worden 3 dagen bewaard. Het prijsartikel heeft meer budgetten, en de API-gids heeft een pollinglus die je voor elke ronde kunt hergebruiken.
Veelgestelde vragen
Hoe zet ik exacte tekst op een afbeelding met de Ideogram 4.6 API?
Zet elke regel tussen aanhalingstekens in de prompt van een ideogram-v4.6-request en beschrijf de grootte en positie. Controleer het resultaat vóór publicatie.
Hoe wijzig ik de tekst op een bestaande afbeelding met de Ideogram 4.6 API?
Stuur de afbeelding naar ideogram-v4.6-edit met een prompt zoals: Change only the date line to "NEW TEXT". Keep everything else exactly the same. Stel edit_precision: high en size: auto in.
Wat is het verschil tussen edit_precision regular en high?
regular genereert de afbeelding opnieuw vanuit de prompt en staat een nieuw formaat en background toe. high voert een precieze bewerking uit, herstelt ongewijzigde pixels en behoudt de resolutie van de bron.
Verandert een masker de prijs van de Ideogram 4.6 API? Nee. Bewerkingen worden per outputafbeelding afgerekend op kwaliteits- en formaatniveau. Het masker en tot 3 referenties zijn inbegrepen.
Waarom kostte een kleine tekstbewerking 120 credits?
Een bewerking met hoge precisie en kwaliteit high van een bron boven 4,194,304 pixels gebruikt het 4K-high-bewerkingstarief. Bewerk een kleinere bron, of gebruik medium (40 credits bij 4K, 12 bij 2K).
Voor de volledige parameterlijst, zie de Ideogram 4.6 Edit API-referentie. Voor een set geteste promptpatronen lees je de Ideogram 4.6 API-promptgids.