
Ideogram 4.6 API, çoğu görsel API'sinin kötü yönettiği bir iş akışı için tasarlanmıştır: üzerinde kesin kelimeler olan bir poster üretmek, ardından geri kalanını yeniden çizmeden bu metnin tek bir satırını değiştirmek. Bu rehber iki yarıyı da istek gövdeleriyle ele alıyor: ideogram-v4.6 ile görsel üzerinde metin ve ideogram-v4.6-edit ile yüksek hassasiyetli, maskeli ve yerel düzenlemeler. Buradaki her şey PoYo'daki Ideogram 4.6 modeli üzerinde çalışır ve rakamlar 20 Kasım 2026'daki lansman günü testimizden gelir.
Bölüm 1: Ideogram 4.6 API ile görsel üzerinde kesin metin
PoYo dokümanları metin için tek bir kural verir: görsel üzerindeki kesin metni promptta tırnak içine alın. Her satırın nereye gideceğini ve ne kadar büyük olacağını, bir tasarımcıya brief verir gibi tarif edin.
Lansman günü testimizdeki istek şuydu (görev 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
}
}
İstek yaklaşık 10.8 MB'lık bir adet 2304×3072 PNG döndürdü ve 4K high fiyatı olan 40 kredi ($0.20) ile ücretlendirildi. Tırnak içindeki üç satırın üçü de, küçük italik satır dahil, yazıldığı gibi oluşturuldu. Aynı prompt quality: very_low ve size: 3:4 ile (görev BS7M64COKT80JSLX) 1.6 krediye ($0.008) 768×1024 bir taslak döndürdü; metin yine doğruydu ama kompozisyon farklıydı.
Üç alışkanlık, üretim ortamında metin isteklerini daha güvenilir hale getirir:
| Alışkanlık | Neden |
|---|---|
| Her metin satırı için tırnak içinde ayrı bir dize | Her satır, kontrol edebileceğiniz ve daha sonra düzenleyebileceğiniz ayrı bir birimdir |
| Her satırın boyutunu ve konumunu belirtin ("üstte büyük başlık", "altında daha küçük bir satır") | Hiyerarşi isteğin bir parçası olur, şansa bırakılmaz |
| Yayınlamadan önce çıktıyı kontrol edin | Ideogram'ın kendisi de öneriyor: "Nihai sonuçta yazımı ve yerleşimi kontrol edin." |
Bu API'de prompt genişletme her zaman açıktır, bu yüzden model istemediğiniz detaylar ekleyebilir. Posterimizde alt köşelere küçük bir "EST. 1987" ve bir web adresi ekledi. Bir yerleşimde yalnızca sizin kelimeleriniz olması gerekiyorsa bunu promptta belirtin ve sonucu kontrol edin ya da fazlalıkları bir düzenlemeyle kaldırın.
Bölüm 2: ideogram-v4.6-edit ile düzenlemenin üç yolu
Her düzenleme image_urls içinde tam olarak bir kaynak görsel ve bir prompt alır. Aşağıdaki ayarlar, modelin görselin ne kadarına dokunabileceğini belirler. Uygulamanız kullanıcıların kaynağı yüklemesine izin veriyorsa, önce onu taramak başarısız görevlerden tasarruf ettirir; görsel moderasyonu rehberi bunun bir yolunu gösteriyor.
| Mod | Ayarlar | Ne korunur | Çıktı boyutu |
|---|---|---|---|
| Normal düzenleme | edit_precision: regular (varsayılan) | Görsel prompttan yeniden üretilir | auto veya maskesiz herhangi bir hazır/özel boyut |
| Yüksek hassasiyetli düzenleme | edit_precision: high, context_window: none | Değişmeyen pikseller geri yüklenir | Kaynak çözünürlüğü |
| Yerel düzenleme | edit_precision: high, context_window: auto, mask_url | Maskenin çevresindeki bölgenin dışındaki her piksel | Kaynak çözünürlüğü |
Ideogram, 4.6'nın "düzenlemelerinizin dışında çok daha az piksel kayması bıraktığını" söylüyor ve model sayfasında maskeli düzenlemeler ("yalnızca boyanan alanı değiştirme") için Ideogram 4.5'in %82'sine karşı %90 bildiriyor. Bunlar Ideogram'ın puanlarıdır. Bizim ölçtüklerimiz şunlar.
Yüksek hassasiyetli düzenleme: tek bir metin satırını değiştirme
{
"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
}
}
Testimizde (görev 672JRU198S22NS8D) kaynak, Bölüm 1'deki 2304×3072 posterdi. Çıktı, yeni tarih satırıyla birlikte 2304×3072 oldu. Orijinale karşı yapılan piksel farkı karşılaştırması, değişen her pikseli (471, 2699) ile (1826, 2756) arasındaki tek bir kutuya yerleştirdi: tarih satırı, görselin yaklaşık %1.1'i. Başlık, görsel çalışma ve küçük italik satır değişmedi. Ücret 120 kredi ($0.60) oldu, çünkü yüksek hassasiyetli bir düzenleme kaynak çözünürlüğünü korur ve 2304×3072, 4,194,304 pikselin üzerindedir.
Akılda tutulacak iki kural: edit_precision: high, size: auto gerektirir (veya size olmadan) ve background alanını reddeder.
Maskeli düzenleme: değişikliği tek bir alanla sınırlama
Maske, düzenlemenin nereye gideceği konusundaki tahmini ortadan kaldırır. Kaynakla aynı boyutlarda olmalı; modelin düzenleyebileceği yerler siyah, koruması gereken yerler beyaz olmalı ve ikisini de içermelidir. Bu Python parçası bir kutudan maske oluşturur:
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")
Maskeyi yükleyin (herkese açık URL veya base64 data URI) ve isteğe ekleyin:
{
"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"
}
}
context_window: auto ile yalnızca maskenin çevresindeki bölge düzenlenir ve kaynak çözünürlüğü korunur. Çok büyük bir maske, görselin tamamını düzenlemeye geri döner. Hem mask_url hem de edit_precision: high olmadan gönderilen context_window: auto reddedilir ve bir maske her zaman size: auto gerektirir. Maskeyle birlikte reference_image_urls içinde en fazla 3 referans görsel ekleyebilirsiniz, örneğin bir logo veya bir yazı tipi örneği.
Bölüm 3: düzenlemeyi iş akışınızda doğrulayın
Uygulamanız "yalnızca metin değişti" sözü veriyorsa bunu kontrol edin. Bu, lansman günü düzenlemesinde çalıştırdığımız kontrolün aynısıdır:
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")
Kutuyu değiştirmek istediğiniz alanla, örneğin maskenizle karşılaştırın. Kutu bu alanın çok ötesine yayılıyorsa bir maske ve context_window: auto ile ya da daha sıkı bir promptla yeniden deneyin.
Bölüm 4: çok turlu düzenlemeler ve maliyet
Bir dizi değişiklik için her sonucu bir sonraki image_urls kaynağı olarak geri gönderin ve her istekte tek bir şeyi değiştirin. Ideogram'ın sayfası 4.6'yı "aynı görseli birden fazla turda iyileştirmeye devam etmek" için yapılmış olarak tanımlıyor. Her tur ayrı bir görevdir ve çıktı boyutuna göre ücretlendirilir:
| Bir kaynağın düzenlemesi... | medium | high |
|---|---|---|
| 4,194,304 piksele kadar | 12 kredi ($0.06) | 44 kredi ($0.22) |
| 4,194,304 pikselin üzerinde | 40 kredi ($0.20) | 120 kredi ($0.60) |
4K posterimizde üç high metin değişikliği 360 kredi ($1.80) tutar; aynı posterin 1728×2304 sürümünde 132 kredi ($0.66) tutar. Her sonucu indirin: üretilen dosyalar 3 gün saklanır. Fiyat yazısında daha fazla bütçe örneği, API rehberinde ise her turda yeniden kullanabileceğiniz bir sorgulama döngüsü var.
Sık sorulan sorular
Ideogram 4.6 API ile bir görselin üzerine kesin metni nasıl yazarım?
Her satırı bir ideogram-v4.6 isteğinin prompt alanında tırnak içine alın ve boyutunu ve konumunu tarif edin. Yayınlamadan önce sonucu kontrol edin.
Ideogram 4.6 API ile mevcut bir görseldeki metni nasıl değiştiririm?
Görseli şu gibi bir promptla ideogram-v4.6-edit modeline gönderin: Change only the date line to "NEW TEXT". Keep everything else exactly the same. edit_precision: high ve size: auto ayarlayın.
edit_precision regular ile high arasındaki fark nedir?
regular görseli prompttan yeniden üretir ve yeni bir boyuta ve background alanına izin verir. high hassas bir düzenleme yapar, değişmeyen pikselleri geri yükler ve kaynak çözünürlüğünü korur.
Maske Ideogram 4.6 API fiyatını değiştirir mi? Hayır. Düzenlemeler kalite ve boyut katmanına göre çıktı görseli başına ücretlendirilir. Maske ve en fazla 3 referans dahildir.
Küçük bir metin düzenlemesi neden 120 kredi tuttu?
4,194,304 pikselin üzerindeki bir kaynağın high kaliteli, yüksek hassasiyetli düzenlemesi 4K high düzenleme fiyatını kullanır. Daha küçük bir kaynağı düzenleyin veya medium kullanın (4K'da 40 kredi, 2K'da 12).
Parametre listesinin tamamı için Ideogram 4.6 Edit API referansına bakın. Test edilmiş prompt kalıpları için Ideogram 4.6 API prompt rehberini okuyun.