guides

Ideogram 4.6 API: Apa Itu Ideogram 4.6, Harga, Batas, dan Edit 4K

Poyo.ai Team
9 min read
Share:

Ideogram 4.6 API di PoYo

Ideogram 4.6 API memberi Anda akses ke model gambar terbaru Ideogram melalui satu endpoint REST di PoYo: ideogram-v4.6 untuk text-to-image dan ideogram-v4.6-edit untuk mengedit satu gambar sumber dengan mask dan gambar referensi opsional. Output bisa mencapai 4096 piksel per sisi, harga mulai dari 1.6 kredit ($0.008) per gambar, dan setiap request memakai API key yang sama dengan layanan PoYo lainnya. Halaman ini membahas apa itu Ideogram 4.6, batas pastinya, tingkatan harganya, dan hasil yang kami ukur pada hari peluncuran.

Apa itu Ideogram 4.6?

Ideogram 4.6 adalah model pembuatan dan pengeditan gambar dari Ideogram, dirilis pada 19 November 2026. Ideogram menyebutnya "our most precise editing model yet" dan menyatakan model ini "generates images in native 4K", dengan "no upscaling". Di halaman modelnya, Ideogram juga menyatakan model ini "leaves far less pixel drift outside your edits and holds color more accurately".

Ideogram mendukung klaim itu dengan skor per tugas pada kualitas tinggi, membandingkan 4.6 dengan 4.5:

Tugas (deskripsi Ideogram)Ideogram 4.6Ideogram 4.5
Warna persis: mewarnai ulang objek dengan kode hex merek83%46%
Detail produk: memperbaiki cacat kecil pada foto produk86%61%
Foto produk: menata, mengubah gaya, dan memberi label ulang produk88%66%
Konsistensi karakter: menjaga seseorang tetap dikenali di adegan baru85%69%
Edit dengan mask: hanya mengubah area yang diwarnai90%82%

Ini adalah angka dari Ideogram, bukan hasil pengukuran PoYo. Untuk integrasi API, angka ini menunjuk tiga jenis request yang layak dikirim ke sini:

  • Poster, label, dan grafis media sosial dengan kata-kata persis: tulis teksnya dalam tanda kutip di prompt.
  • Edit yang tidak boleh mengubah bagian lain: tanggal baru di flyer, produk yang diwarnai ulang, satu detail yang diubah.
  • Cetakan berukuran besar: ukuran kustom hingga 4096 piksel per sisi tanpa langkah upscaling terpisah.

Sekilas Ideogram 4.6 API

Text-to-imageEdit
ID model PoYoideogram-v4.6ideogram-v4.6-edit
Endpoint submitPOST https://api.poyo.ai/api/generate/submitSama
HasilPolling GET /api/generate/status/{task_id} atau gunakan callback_urlSama
Inputpromptprompt + tepat satu gambar di image_urls, mask_url dan reference_image_urls opsional
Gambar per request1 sampai 8 (n)1 sampai 8 (n)
Tingkat kualitasvery_low, low, medium (default), highSama
Rilis Ideogram19 November 202619 November 2026
DokumentasiReferensi API Ideogram V4.6Referensi Ideogram V4.6 Edit

Kedua ID berbagi autentikasi, polling, dan penagihan, sehingga aplikasi bisa membuat gambar dengan satu ID dan menyempurnakannya dengan ID lain tanpa integrasi kedua.

Batas dan field request

FieldAturan di PoYo
promptWajib, 1 sampai 10,000 karakter, harus berisi teks selain spasi. Tulis teks yang harus muncul di gambar dalam tanda kutip.
sizeauto (default), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16, atau WIDTHxHEIGHT kustom
Ukuran kustomx huruf kecil, kedua sisi 256 sampai 4096 piksel dan kelipatan 32, rasio aspek antara 1:6 dan 6:1
qualityvery_low, low, medium (default), high; very_low hanya sampai 4,194,304 piksel
nBilangan bulat 1 sampai 8
backgroundtransparent atau opaque; hanya untuk text-to-image dan edit reguler
seedBilangan bulat 0 sampai 2,147,483,647
image_urls (edit)Tepat satu gambar sumber, URL HTTP(S) publik atau data URI base64, selalu dalam bentuk array
mask_url (edit)Dimensi sama dengan sumber; hitam diedit, putih dipertahankan; membutuhkan size: auto
reference_image_urls (edit)0 sampai 4 gambar, atau maksimal 3 jika memakai mask
edit_precision (edit)regular (default) atau high; high membutuhkan size: auto dan menolak background
context_window (edit)none (default) atau auto; auto membutuhkan mask_url dan edit_precision: high

Field lain di dalam input ditolak dengan error unsupported fields. File yang dihasilkan tersedia selama 3 hari, jadi salin ke penyimpanan Anda sendiri.

Harga Ideogram 4.6 API

PoYo menagih per gambar output, berdasarkan kualitas dan tingkatan ukuran. "2K" berarti output hingga 4,194,304 piksel (setara luas 2048×2048); yang lebih besar dari itu adalah "4K". 1 kredit = $0.005.

KualitasText-to-image 2KText-to-image 4KEdit 2KEdit 4K
very_low1.6 kredit ($0.008)tidak tersedia1.6 kredit ($0.008)tidak tersedia
low6 kredit ($0.03)12 kredit ($0.06)6 kredit ($0.03)12 kredit ($0.06)
medium12 kredit ($0.06)24 kredit ($0.12)12 kredit ($0.06)40 kredit ($0.20)
high20 kredit ($0.10)40 kredit ($0.20)44 kredit ($0.22)120 kredit ($0.60)

size: auto dan enam preset selalu 2K untuk text-to-image. Untuk edit dengan size: auto, output mempertahankan geometri sumber, sehingga sumber berukuran besar masuk ke tingkatan 4K. Harga ini sama dengan tabel per gambar di halaman model Ideogram; rincian harga membahasnya dengan bentuk request nyata.

Yang kami ukur pada hari peluncuran

Tim PoYo menjalankan request ini di API produksi PoYo pada 20 November 2026. Prompt-nya adalah poster sablon "NORTHBOUND JAZZ FESTIVAL" dengan baris "JUNE 12-14 · RIVERSIDE PARK" dan "Three nights. Twenty-one bands. Free entry before 6 PM."

TaskRequestOutputDitagih
M4WA9OIQXVV80DHGideogram-v4.6, quality: high, size: 2304x3072, n: 1Satu PNG 2304×3072, sekitar 10.8 MB40 kredit ($0.20)
BS7M64COKT80JSLXPrompt sama, quality: very_low, size: 3:4PNG 768×10241.6 kredit ($0.008)
672JRU198S22NS8Dideogram-v4.6-edit pada poster pertama, edit_precision: high, context_window: none, size: auto, quality: highPNG 2304×3072120 kredit ($0.60)

Semua teks di dua poster pertama keluar persis seperti yang ditulis, termasuk baris kecil bercetak miring; draf memiliki komposisi yang berbeda. Prompt edit-nya adalah: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. Diff piksel terhadap gambar asli menemukan semua piksel yang berubah berada di dalam satu kotak, (471, 2699) sampai (1826, 2756), sekitar 1.1% dari gambar; sisanya tidak berubah. Edit ini memakai tingkatan 4K high karena edit presisi tinggi mempertahankan resolusi sumber. Panduan teks dan edit presisi membahas request tersebut langkah demi langkah.

Request Ideogram 4.6 API pertama Anda

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v4.6",
    "input": {
      "prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
      "size": "2048x3072",
      "quality": "high",
      "n": 2
    }
  }'

2048x3072 berarti 6,291,456 piksel, jadi request ini ditagih dengan tarif 4K high: 2 × 40 = 80 kredit ($0.40). Respons berisi data.task_id dengan status not_started. Lakukan polling ke endpoint status sampai statusnya finished lalu baca gambar dari data.files, atau kirim callback_url di level teratas. Selalu periksa code di body: beberapa error validasi mengembalikan HTTP 200 dengan code: 400. Panduan API berisi loop polling Python yang dibatasi waktu dan body untuk setiap mode input.

Di mana Ideogram 4.6 tersedia

Ideogram menyediakan 4.6 di aplikasi dan API miliknya sendiri, dengan dua endpoint: Generate dan Precise Edit. Di PoYo Anda memanggilnya dengan key yang sama untuk semua model lain, alur task dan callback yang sama, serta Playground di halaman model yang menampilkan harga sebelum setiap run. Di PoYo, gambar referensi dikirim melalui ideogram-v4.6-edit; ID text-to-image hanya menerima prompt ditambah pengaturan ukuran, kualitas, n, background, dan seed.

Request mana diarahkan ke mana

RequestID model dan pengaturan
Draf dan eksplorasi tata letakideogram-v4.6, very_low atau low, ukuran preset, n hingga 8
Poster final dan grafis media sosial hingga setara luas 2048×2048ideogram-v4.6, high, ukuran kustom seperti 1728x2304
Cetak dan karya format besarideogram-v4.6, low sampai high, ukuran kustom di atas 4,194,304 piksel
Ubah satu detail dan pertahankan sisanyaideogram-v4.6-edit, edit_precision: high
Lukis ulang satu area dari gambar besarideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto
Ubah gaya dengan referensi, ukuran output baruideogram-v4.6-edit, edit_precision: regular, reference_image_urls, size kustom

Beralih dari Ideogram 4.5? Perbandingan 4.6 vs 4.5 mencantumkan perubahan field, aturan ukuran baru, dan harga untuk request yang sama. Jika sedang menimbang API gambar lain di PoYo, lihat ikhtisar MAI Image 2.7 API dan perbandingan Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.

Pertanyaan yang sering diajukan

Apa ID model Ideogram 4.6 API? Gunakan ideogram-v4.6 untuk text-to-image dan ideogram-v4.6-edit untuk pengeditan. ideogram-4-6 hanyalah slug halaman PoYo dan bukan ID model.

Berapa biaya Ideogram 4.6 API? Mulai dari 1.6 kredit ($0.008) per gambar pada very_low 2K. Gambar medium 2K default adalah 12 kredit ($0.06), high adalah 20 kredit ($0.10) pada 2K dan 40 kredit ($0.20) pada 4K. Edit 4K kualitas tinggi adalah 120 kredit ($0.60).

Seberapa besar gambar terbesar yang bisa dihasilkan Ideogram 4.6 API? Ukuran kustom bisa mencapai 4096 piksel per sisi, dalam kelipatan 32, dengan rasio aspek antara 1:6 dan 6:1. Apa pun di atas 4,194,304 piksel ditagih pada tingkatan 4K.

Apakah Ideogram 4.6 API bisa merender teks pada gambar? Ya, tulis kata-kata persisnya dalam tanda kutip di prompt. Dalam uji hari peluncuran kami, poster 2304×3072 merender judul, baris tanggal, dan baris kecil bercetak miring persis seperti yang ditulis. Ideogram tetap menyarankan untuk memeriksa ejaan dan penempatan pada hasil akhir.

Apakah Ideogram 4.6 API bisa mengembalikan gambar transparan? Ya. Atur background ke transparent untuk text-to-image atau edit reguler. Edit presisi tinggi menolak background.

Apakah Ideogram 4.6 API kompatibel dengan OpenAI SDK? Tidak. Ini adalah API task asinkron: submit ke /api/generate/submit, lalu polling /api/generate/status/{task_id} atau terima callback.

Share: