
Ideogram 4.6 API dibuat untuk alur kerja yang kurang ditangani dengan baik oleh sebagian besar API gambar: membuat poster dengan kata-kata persis di atasnya, lalu mengubah satu baris teks itu tanpa menggambar ulang sisanya. Tutorial ini membahas kedua bagian tersebut lengkap dengan body request: teks pada gambar dengan ideogram-v4.6, serta edit presisi tinggi, edit dengan mask, dan edit lokal dengan ideogram-v4.6-edit. Semua contoh di sini dijalankan pada model Ideogram 4.6 di PoYo, dan angkanya berasal dari uji hari peluncuran kami pada 20 November 2026.
Bagian 1: teks persis pada gambar dengan Ideogram 4.6 API
Dokumentasi PoYo memberikan satu aturan untuk teks: tulis teks yang harus muncul di gambar dalam tanda kutip di prompt. Jelaskan di mana setiap baris ditempatkan dan seberapa besar ukurannya, seperti saat Anda memberi brief kepada desainer.
Berikut request dari uji hari peluncuran kami (task 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
}
}
Request ini mengembalikan satu PNG 2304×3072 berukuran sekitar 10.8 MB dan ditagih 40 kredit ($0.20), tarif 4K high. Ketiga baris dalam tanda kutip dirender persis seperti yang ditulis, termasuk baris kecil bercetak miring. Prompt yang sama dengan quality: very_low dan size: 3:4 (task BS7M64COKT80JSLX) mengembalikan draf 768×1024 seharga 1.6 kredit ($0.008), juga dengan teks yang benar tetapi komposisi yang berbeda.
Tiga kebiasaan membuat request teks lebih andal di produksi:
| Kebiasaan | Alasan |
|---|---|
| Satu string dalam tanda kutip per baris teks | Setiap baris menjadi unit terpisah yang bisa Anda periksa dan edit nanti |
| Sebutkan ukuran dan posisi setiap baris ("judul besar di atas", "baris lebih kecil di bawahnya") | Hierarki menjadi bagian dari request, tidak dibiarkan pada kebetulan |
| Periksa output sebelum dipublikasikan | Ideogram sendiri menyarankan: "Check spelling and placement in the final result." |
Ekspansi prompt selalu aktif untuk API ini, sehingga model bisa menambahkan detail yang tidak Anda minta. Pada poster kami, model menambahkan "EST. 1987" kecil dan alamat web di sudut bawah. Jika sebuah tata letak hanya boleh berisi kata-kata Anda, nyatakan itu di prompt dan periksa hasilnya, atau hapus tambahan tersebut dengan edit.
Bagian 2: tiga cara mengedit dengan ideogram-v4.6-edit
Setiap edit menerima tepat satu gambar sumber di image_urls dan sebuah prompt. Pengaturan di bawah menentukan seberapa banyak bagian gambar yang boleh disentuh model. Jika aplikasi Anda mengizinkan pengguna mengunggah sumbernya, menyaringnya terlebih dahulu akan mengurangi task yang gagal; panduan moderasi gambar menunjukkan salah satu caranya.
| Mode | Pengaturan | Yang dipertahankan | Ukuran output |
|---|---|---|---|
| Edit reguler | edit_precision: regular (default) | Gambar dibuat ulang dari prompt | auto atau ukuran preset/kustom apa pun tanpa mask |
| Edit presisi tinggi | edit_precision: high, context_window: none | Piksel yang tidak berubah dipulihkan | Resolusi sumber |
| Edit lokal | edit_precision: high, context_window: auto, mask_url | Setiap piksel di luar area sekitar mask | Resolusi sumber |
Ideogram menyatakan 4.6 "leaves far less pixel drift outside your edits", dan melaporkan 90% untuk edit dengan mask ("change only the painted area") dibandingkan 82% untuk Ideogram 4.5 di halaman modelnya. Itu adalah skor dari Ideogram. Berikut yang kami ukur.
Edit presisi tinggi: ubah satu baris teks
{
"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
}
}
Dalam uji kami (task 672JRU198S22NS8D), sumbernya adalah poster 2304×3072 dari Bagian 1. Output-nya 2304×3072 dengan baris tanggal yang baru. Diff piksel terhadap gambar asli menempatkan semua piksel yang berubah di dalam satu kotak, dari (471, 2699) sampai (1826, 2756): baris tanggal, sekitar 1.1% dari gambar. Judul, ilustrasi, dan baris kecil bercetak miring tidak berubah. Biayanya 120 kredit ($0.60), karena edit presisi tinggi mempertahankan resolusi sumber dan 2304×3072 berada di atas 4,194,304 piksel.
Dua aturan yang perlu diingat: edit_precision: high membutuhkan size: auto (atau tanpa size), dan menolak background.
Edit dengan mask: batasi perubahan pada satu area
Mask menghilangkan tebakan tentang di mana edit dilakukan. Mask harus berdimensi sama dengan sumber, hitam di area yang boleh diedit model, putih di area yang harus dipertahankan, dan berisi keduanya. Snippet Python ini membuat mask dari sebuah kotak:
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")
Unggah mask tersebut (URL publik atau data URI base64) dan tambahkan ke 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"
}
}
Dengan context_window: auto, hanya area di sekitar mask yang diedit dan resolusi sumber dipertahankan. Mask yang terlalu besar akan kembali ke pengeditan seluruh gambar. context_window: auto tanpa mask_url dan edit_precision: high sekaligus akan ditolak, dan mask selalu membutuhkan size: auto. Anda bisa menambahkan hingga 3 gambar referensi bersama mask, misalnya logo atau contoh font, di reference_image_urls.
Bagian 3: verifikasi edit di pipeline Anda
Jika aplikasi Anda menjanjikan "hanya teksnya yang berubah", periksalah. Ini adalah jenis pemeriksaan yang sama dengan yang kami jalankan pada edit hari peluncuran:
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")
Bandingkan kotak tersebut dengan area yang ingin Anda ubah, misalnya mask Anda. Jika kotaknya melebar jauh di luar area itu, coba lagi dengan mask dan context_window: auto, atau dengan prompt yang lebih ketat.
Bagian 4: edit multi-putaran dan biaya
Untuk serangkaian perubahan, kirim kembali setiap hasil sebagai sumber image_urls berikutnya dan ubah satu hal per request. Halaman Ideogram menggambarkan 4.6 dibuat untuk "keep refining the same image across multiple turns". Setiap putaran adalah task terpisah, ditagih berdasarkan ukuran output:
| Edit dari sumber... | medium | high |
|---|---|---|
| Hingga 4,194,304 piksel | 12 kredit ($0.06) | 44 kredit ($0.22) |
| Di atas 4,194,304 piksel | 40 kredit ($0.20) | 120 kredit ($0.60) |
Tiga perubahan teks high pada poster 4K kami akan berbiaya 360 kredit ($1.80); pada versi 1728×2304 dari poster yang sama biayanya 132 kredit ($0.66). Unduh setiap hasil: file yang dihasilkan disimpan selama 3 hari. Artikel harga berisi lebih banyak contoh anggaran, dan panduan API memiliki loop polling yang bisa Anda pakai ulang di setiap putaran.
Pertanyaan yang sering diajukan
Bagaimana cara menaruh teks persis pada gambar dengan Ideogram 4.6 API?
Tulis setiap baris dalam tanda kutip di prompt request ideogram-v4.6 dan jelaskan ukuran serta posisinya. Periksa hasilnya sebelum dipublikasikan.
Bagaimana cara mengubah teks pada gambar yang sudah ada dengan Ideogram 4.6 API?
Kirim gambar ke ideogram-v4.6-edit dengan prompt seperti: Change only the date line to "NEW TEXT". Keep everything else exactly the same. Atur edit_precision: high dan size: auto.
Apa perbedaan edit_precision regular dan high?
regular membuat ulang gambar dari prompt dan mengizinkan ukuran baru serta background. high melakukan edit presisi, memulihkan piksel yang tidak berubah, dan mempertahankan resolusi sumber.
Apakah mask mengubah harga Ideogram 4.6 API? Tidak. Edit ditagih per gambar output berdasarkan tingkatan kualitas dan ukuran. Mask dan hingga 3 referensi sudah termasuk.
Mengapa edit teks kecil berbiaya 120 kredit?
Edit presisi tinggi kualitas high dari sumber di atas 4,194,304 piksel memakai tarif edit 4K high. Edit sumber yang lebih kecil, atau gunakan medium (40 kredit pada 4K, 12 pada 2K).
Untuk daftar parameter lengkap, lihat referensi API Ideogram 4.6 Edit. Untuk kumpulan pola prompt yang sudah diuji, baca panduan prompt Ideogram 4.6 API.