Ingin memanggil gpt-image-2 langsung di ComfyUI lokal untuk pembuatan gambar (teks ke gambar), perbaikan Mask, atau penggabungan banyak gambar, tetapi terhambat oleh lingkungan jaringan, kuota, atau kontrol parameter dari node resmi OpenAI? Artikel ini akan memandu Anda melalui jalur tercepat: instal satu plugin komunitas, ganti gateway, dan aktifkan node gpt-image-2 di kanvas ComfyUI dalam 5 menit.
gpt-image-2 adalah model gambar "penalaran sebelum pembuatan" yang diluncurkan OpenAI pada tahun 2026. Model ini sangat ahli dalam tata letak teks padat, infografis UI, papan cerita komik, dan pengeditan Mask yang presisi, dengan menjaga stabilitas piksel di area non-edit. Namun, untuk memasukkannya ke dalam alur kerja node ComfyUI, Partner Nodes resmi seringkali tidak ramah bagi pengguna di banyak wilayah: entah harus melalui Comfy Cloud atau tersangkut di tahap autentikasi.
Comfyui-Luck-gpt2.0 adalah solusi akses gpt-image-2 yang paling stabil di komunitas ComfyUI saat ini. Plugin ini menyediakan dua node sekaligus: "kontrol presisi" dan "batch ekonomis", yang memungkinkan output 4K berkualitas tinggi maupun batch sketsa seharga $0,03/gambar. Backend hanya perlu dihubungkan ke layanan proksi API yang kompatibel dengan antarmuka OpenAI. Kami merekomendasikan APIYI apiyi.com yang menyediakan tiga jalur: api.apiyi.com / vip.apiyi.com / b.apiyi.com, dengan Bearer Token yang siap pakai.
Setelah mengikuti tutorial akses ComfyUI ke gpt-image-2 ini, Anda akan mendapatkan:
- Node
Luck gpt-image-2/Luck gpt-2.0 allyang bisa dicari dengan klik dua kali di kanvas ComfyUI - Panduan parameter untuk 1K/2K/4K, 15 rasio aspek, dan perbaikan Mask
- Dua contoh alur kerja yang siap pakai (teks ke gambar 4K + inpainting lokal Mask)
- Daftar perbaikan masalah untuk menghindari error umum seperti timeout, 429, dan format Mask
Satu. Mengapa Harus Mengakses gpt-image-2 di ComfyUI?
1.1 Tiga kemampuan baru yang dibawa gpt-image-2 ke ComfyUI
Sebelum adanya gpt-image-2, pembuatan poster teks atau infografis UI di kanvas ComfyUI biasanya mengandalkan kombinasi SDXL + ControlNet, yang seringkali menghasilkan teks buram atau tata letak yang berantakan. gpt-image-2 adalah model gambar pertama dari OpenAI yang "bernalar sebelum membuat". Model ini merencanakan komposisi terlebih dahulu sebelum menggambar, sehingga sangat cocok untuk skenario ComfyUI yang memerlukan kolaborasi dengan node lain:
| Kemampuan | Solusi Lokal Sebelumnya | Setelah Akses gpt-image-2 |
|---|---|---|
| Rendering teks padat | Perlu perbaikan pasca-OCR | Langsung menghasilkan tata letak "daftar 7 item 11pt Helvetica rata tengah" |
| Inpainting lokal Mask | Inpaint sering merusak piksel sekitar | "Stabilitas piksel" di luar area edit, tidak merusak wajah atau mengubah komposisi |
| Konsistensi referensi gambar | Penyetelan parameter IPAdapter rumit | Hingga 5 gambar referensi, langsung menjaga konsistensi karakter/produk |
| Resolusi ultra-tinggi | Hires.fix yang merepotkan | Dukungan asli 1K/2K/4K dalam satu kali proses |
1.2 Mengapa memilih Comfyui-Luck-gpt2.0 daripada node resmi?
Node resmi ComfyUI menambahkan node OpenAI GPT-Image melalui Partner Nodes di v0.19.4, tetapi secara default menggunakan koneksi langsung ke OpenAI, yang seringkali tersangkut pada jabat tangan SSL atau pembatasan laju 429 di lingkungan dengan jaringan terbatas. Inilah nilai dari Comfyui-Luck-gpt2.0:
- ✅ Ramah Pengguna: Secara default terhubung ke layanan proksi API yang kompatibel dengan antarmuka OpenAI, dengan situs utama
api.apiyi.com+ dua cadangan - ✅ Parameter lebih lengkap: Mengekspos parameter presisi seperti
image_size,quality,output_compression, danoutput_formatdibandingkan node resmi - ✅ Kombinasi dua node: Memiliki node "kontrol presisi" dan node "ekonomis" yang dihitung per gambar
- ✅ Prompt bahasa Mandarin: Node ini memiliki pemahaman semantik bahasa Mandarin yang lebih stabil
💡 Saran Gateway: Tutorial ini menggunakan APIYI
apiyi.comsebagai pintu masuk akses gpt-image-2. Layanan ini mendukung format Responses API dan Images API, yang sangat cocok dengan dua jenis endpoint node Comfyui-Luck-gpt2.0, sehingga menghemat waktu adaptasi.
1.3 Untuk siapa tutorial ini?
| Peran Anda | Apa yang Anda dapatkan dari tutorial ini |
|---|---|
| Pengguna lama ComfyUI | Menyisipkan node "sampul/poster" berkualitas tinggi ke alur kerja yang ada, tanpa perlu perbaikan teks di Photoshop |
| Fotografer komersial AIGC | Perbaikan Mask + banyak gambar referensi, mereplikasi konsistensi produk/model dengan stabil |
| Kreator konten/Blogger | Pembuatan sampul 4K rasio 2:3 sekali klik, menggantikan pustaka gambar eksternal |
| Pengembang | Menggunakan ComfyUI sebagai shell Stable Diffusion lokal, melakukan integrasi pengujian API dengan gpt-image-2 |
二、Komponen Inti Integrasi ComfyUI ke gpt-image-2
2.1 Sekilas tentang Plugin Comfyui-Luck-gpt2.0
Comfyui-Luck-gpt2.0 adalah paket node kustom ComfyUI sumber terbuka yang repositori GitHub-nya ada di github.com/luckdvr/Comfyui-Luck-gpt2.0. Ini bukan sekadar satu node, melainkan sebuah "suite"—setelah diinstal, ia akan mendaftarkan dua node independen di menu node ComfyUI:
Comfyui-Luck-gpt2.0
├── Luck gpt-image-2 # Node transmisi langsung: kontrol presisi, parameter size asli
└── Luck gpt-2.0 all # Node transmisi balik: mode ekonomis, endpoint dapat dialihkan
Antarmuka kedua node ini konsisten, keduanya mengharuskan Anda menyediakan:
base_urlyang kompatibel dengan protokol OpenAI (direkomendasikan APIYIapi.apiyi.com)- Token dengan format
Bearer YOUR_API_KEY - Input teks (petunjuk) atau gambar
2.2 Cara Memilih Antara Kedua Node: Tabel Perbandingan
Ini adalah tabel terpenting dalam artikel ini, pahami ini sebelum melanjutkan:
| Dimensi Perbandingan | Luck gpt-image-2 (Langsung) | Luck gpt-2.0 all (Balik) |
|---|---|---|
| Model Backend | gpt-image-2 |
gpt-image-2-all |
| Posisi | Kontrol presisi, hasil berkualitas tinggi | Ekonomis massal, ramah bahasa Mandarin |
| Parameter size | ✅ Field size asli |
❌ Hanya melalui petunjuk (prompt) |
| Opsi Resolusi | AUTO / 1K / 2K / 4K / Kustom | Ukuran default |
| Rasio Aspek | 15 preset + WxH kustom | Melalui deskripsi petunjuk |
| Mask Inpainting | ✅ Didukung | ❌ Tidak didukung |
| Jumlah Gambar Referensi | Maksimal 5 gambar | Maksimal 5 gambar |
| Opsi Kualitas | auto / low / medium / high | Tetap |
| Format Output | PNG / JPEG / WebP | PNG |
| Pengalihan Endpoint | images_api tetap |
chat_completions / images_api dapat diubah |
| Estimasi Harga | Berdasarkan token | Sekitar $0,03/gambar |
| Skenario Cocok | Poster, sampul, foto komersial, perbaikan Mask | Draf massal, konsep, petunjuk bahasa Mandarin |
2.3 Backend API: Mengapa Merekomendasikan APIYI apiyi.com
Comfyui-Luck-gpt2.0 sendiri hanyalah "cangkang", yang benar-benar memanggil gpt-image-2 adalah gateway yang Anda isi di base_url. Ia mengharapkan gateway memenuhi dua poin:
- Sepenuhnya kompatibel dengan protokol OpenAI: Rute
/v1/images/generations,/v1/responses, dan/v1/chat/completionslengkap. - Memiliki rute asli untuk gpt-image-2: Dapat mengenali
model=gpt-image-2danmodel=gpt-image-2-all.
🎯 Saran Integrasi: Kami menyarankan untuk mengakses gpt-image-2 melalui platform APIYI apiyi.com. Platform ini mendukung mode transmisi langsung gpt-image-2 dan mode transmisi balik gpt-image-2-all, menggunakan autentikasi Bearer Token yang terpadu. Situs utama
api.apiyi.comdan jalur cadanganvip.apiyi.com/b.apiyi.comakan beralih secara otomatis, yang secara signifikan mengurangi tingkat kegagalan saat ComfyUI melakukan pemrosesan batch akibat gangguan pada satu jalur keluar.
Skenario penggunaan untuk domain yang berbeda adalah sebagai berikut:
| Domain | Posisi | Skenario Penggunaan |
|---|---|---|
api.apiyi.com |
Situs Utama | Pilihan default, pemanggilan harian stasiun kerja ComfyUI |
vip.apiyi.com |
Jalur Konkurensi Tinggi | Pemrosesan gambar massal, pemrosesan paralel multi-node, antrean malam hari |
b.apiyi.com |
Jalur Keluar Cadangan | Fallback otomatis saat situs utama mengalami fluktuasi |
Ketiga jalur tersebut berbagi satu set Kunci API, Anda hanya perlu mengubah satu string di node Comfyui-Luck-gpt2.0 untuk beralih.
Tiga. Langkah Lengkap Instalasi ComfyUI untuk gpt-image-2
3.1 Pemeriksaan Lingkungan Awal
Sebelum memulai, pastikan lingkungan ComfyUI Anda memenuhi syarat berikut:
| Item | Persyaratan | Perintah Pemeriksaan |
|---|---|---|
| Versi ComfyUI | Disarankan v0.3+ atau lebih baru | Baris pertama konsol saat startup |
| Versi Python | 3.10 / 3.11 / 3.12 | python3 --version |
| Git Tersedia | Dapat dipanggil langsung di terminal | git --version |
| Ruang Disk | ≥ 500 MB (plugin + dependensi) | df -h |
| Jaringan | Bisa akses GitHub + api.apiyi.com |
curl -I api.apiyi.com |
⚠️ Masalah Umum: Pengguna Windows yang menggunakan paket instalasi sekali klik (seperti versi QiuYe),
python3mungkin mengarah ke Python bawaan paket. Anda perlu menggunakan.\python_embeded\python.exesebagai gantinya.
3.2 Menginstal Plugin: Selesai dalam 4 Langkah
Seluruh proses instalasi plugin ComfyUI untuk gpt-image-2 hanya memerlukan 4 perintah. Buka terminal, masuk ke direktori root ComfyUI Anda, lalu jalankan:
# 1. Masuk ke direktori custom_nodes
cd ComfyUI/custom_nodes
# 2. Klon repositori Comfyui-Luck-gpt2.0
git clone https://github.com/luckdvr/Comfyui-Luck-gpt2.0.git
# 3. Instal dependensi Python
cd Comfyui-Luck-gpt2.0
python3 -m pip install -r requirements.txt
# 4. Restart ComfyUI
Untuk pengguna paket Windows, ganti langkah ke-3 dengan:
cd Comfyui-Luck-gpt2.0
..\..\python_embeded\python.exe -m pip install -r requirements.txt
Setelah restart, perhatikan apakah log berikut muncul di konsol:
[Comfyui-Luck-gpt2.0] Registered node: Luck gpt-image-2
[Comfyui-Luck-gpt2.0] Registered node: Luck gpt-2.0 all
Jika melihat dua baris registrasi berhasil, berarti tahap plugin integrasi ComfyUI gpt-image-2 sudah siap.
3.3 Mendapatkan Kunci API APIYI
- Buka browser dan kunjungi situs resmi APIYI
apiyi.com - Daftar/masuk, lalu buka dasbor → API Keys
- Klik "Buat Kunci Baru", disarankan untuk mengaktifkan "Batasan Kuota", atur kuota awal ¥20–50 untuk verifikasi
- Salin string kunci yang dimulai dengan
sk-dan simpan dengan aman
🔐 Saran Keamanan: Buat kunci baru khusus untuk ComfyUI dan atur batas penggunaan harian. Plugin lokal akan menulis kunci ke dalam parameter node, yang berisiko bocor saat mengekspor JSON alur kerja. Kunci terpisah lebih mudah dibatalkan jika terjadi kebocoran.
3.4 Memasukkan Node ke Kanvas ComfyUI
Setelah membuka ComfyUI:
- Klik dua kali pada area kosong di kanvas untuk memunculkan kotak pencarian node
- Masukkan
Luck gpt-image-2(untuk teks ke gambar) atauLuck gpt-2.0 all(untuk fungsi lengkap) - Pilih node tersebut, ComfyUI akan menempatkannya di posisi kursor Anda
Setelah node muncul, isi tiga kolom kunci berikut:
| Kolom | Nilai | Penjelasan |
|---|---|---|
base_url |
https://api.apiyi.com/v1 |
Alamat situs utama (pastikan menyertakan /v1) |
api_key |
sk-xxxxxxxxxxxxxxxx |
Salin dari dasbor APIYI |
model |
gpt-image-2 atau gpt-image-2-all |
Tergantung node, biasanya sudah terisi otomatis |
3.5 Pembuatan Gambar Pertama: Alur Kerja Minimum
Mari kita gunakan Luck gpt-image-2 untuk menjalankan pembuatan gambar teks ke gambar 1024×1024 yang paling sederhana untuk memverifikasi koneksi:
[Luck gpt-image-2]
├── base_url = https://api.apiyi.com/v1
├── api_key = sk-xxxxxxxx
├── prompt = A minimalist product poster, dark navy background,
│ centered title "HELLO 2026" in large Helvetica font,
│ tiny stars scattered around
├── image_size = 1K
├── aspect_ratio = 1:1
├── quality = medium
└── output_format = png
│
▼
[Preview Image]
Hubungkan output image dari node Luck gpt-image-2 ke node Preview Image bawaan ComfyUI, lalu klik Queue. Setelah sekitar 20–40 detik, sisi kanan kanvas akan menampilkan poster persegi dengan judul "HELLO 2026" yang cantik—jika teks tidak buram dan tata letak berada di tengah, berarti Anda telah berhasil mengintegrasikan gpt-image-2 di ComfyUI.
🎯 Konfirmasi: Jika langkah ini gagal, 90% kemungkinan disebabkan oleh
base_urlyang kurang/v1atau tidak menambahkansk-di depan kunci. Kembali ke dasbor APIYI apiyi.com untuk menyalin kunci lagi, lalu periksa akhirbase_url.
Empat. Referensi Cepat Parameter Inti ComfyUI untuk gpt-image-2
4.1 Resolusi (image_size)
Kolom image_size pada node Luck gpt-image-2 menentukan tingkat resolusi output:
| image_size | Ukuran Aktual (contoh 1:1) | Penggunaan Umum |
|---|---|---|
| AUTO | Penilaian otomatis model | Eksplorasi gambar tanpa batasan ukuran |
| 1K | 1024×1024 | Sketsa, foto profil, stiker |
| 2K | 2048×2048 | Gambar utama artikel, sampul blog |
| 4K | Hingga 3840×3840 | Poster, cetak, layar besar |
| custom | WIDTHxHEIGHT | Iklan khusus, gambar memanjang |
Persyaratan mode custom:
- Lebar dan tinggi harus kelipatan 16
- Sisi terpanjang tidak boleh melebihi 3840 px
- Penulisan yang disarankan:
1600x900,2048x1152,1088x1920
4.2 Rasio Aspek (aspect_ratio)
Node gpt-image-2 mendukung 15 preset rasio aspek, berikut 8 yang paling sering digunakan:
| aspect_ratio | Skenario Penggunaan |
|---|---|
| 1:1 | Foto profil, gambar media sosial, foto produk |
| 16:9 | Sampul blog, sampul video Bilibili |
| 9:16 | Konten vertikal Xiaohongshu/TikTok, wallpaper ponsel |
| 2:3 | Poster film, Pinterest |
| 3:2 | Fotografi, rasio kamera |
| 4:3 | Slide presentasi, PPT |
| 21:9 | Banner lebar, header web |
| 4:5 | Rasio terbaik untuk Instagram |
7 rasio lainnya (seperti 7:4, 5:4, 3:4, dll.) dapat digunakan sesuai kebutuhan. Anda juga bisa memilih custom lalu menulis WxH di custom_size untuk mengganti preset.
4.3 Tingkat Kualitas (quality)
| quality | Kecepatan | Biaya | Skenario Penggunaan |
|---|---|---|---|
| auto | Sedang | Sedang | Serahkan pada model jika ragu |
| low | Cepat | Rendah | Sketsa batch, pratinjau suasana |
| medium | Sedang | Sedang | Ilustrasi blog harian, media sosial |
| high | Lambat | Tinggi | Sampul, poster, materi cetak |
Aturan praktis: Rasio aspek tinggi (21:9) atau resolusi tinggi (4K) harus menggunakan quality=high, jika tidak, detail akan terlihat kurang.
4.4 Format Output dan Kompresi
| output_format | output_compression | Penggunaan |
|---|---|---|
| png | Abaikan | Latar belakang transparan, pengeditan lanjut |
| jpeg | 85–95 | Ilustrasi konten blog |
| webp | 75–85 | Situs web, prioritas seluler |
output_compression hanya berlaku dalam mode jpeg / webp, dengan nilai 0–100. Semakin besar angkanya, semakin besar ukuran file dan semakin baik kualitas gambarnya.
4.5 Gambar Referensi dan Mask
- Gambar Referensi (reference images): Hubungkan hingga 5 input
IMAGE. Model akan menggunakannya sebagai jangkar komposisi/gaya/karakter. - Mask: Hubungkan gambar hitam putih dengan ukuran yang sama persis dengan gambar referensi nomor 1. Piksel putih berarti "edit di sini", piksel hitam berarti "jaga piksel tetap stabil". Ini adalah salah satu kemampuan terkuat gpt-image-2.
🎯 Saran Praktis: Gunakan node
LoadImagedi ComfyUI untuk memuat gambar asli, lalu gunakanMaskToImage/ImageInvertuntuk membuat Mask; jika alur kerja rumit, Anda bisa merujuk pada contoh alur kerja gpt-image-2 di dokumentasi resmi APIYIdocs.apiyi.com, yang bisa langsung di-paste dengan Ctrl+V menjadi alur kerja yang dapat dijalankan.
V. Tiga Alur Kerja Praktis Integrasi ComfyUI dengan gpt-image-2
5.1 Alur Kerja A: Pembuatan Gambar Poster 4K Berkualitas Tinggi
Tujuan: Menghasilkan sampul poster film berukuran 3840×5760 (2:3) dengan teks yang tajam dan komposisi yang terpusat.
[PrimitiveNode: string petunjuk]
│
▼
[Luck gpt-image-2]
├── base_url = https://api.apiyi.com/v1
├── api_key = sk-xxxx
├── prompt = (dari upstream)
├── image_size = 4K
├── aspect_ratio = 2:3
├── quality = high
├── output_format = png
├── timeout = 360
└── max_retries = 3
│
▼
[SaveImage: filename_prefix = poster_4k]
Contoh petunjuk:
A cinematic poster for a sci-fi novel titled "NEON HORIZON",
dark blue and magenta gradient sky, lone silhouette standing on a cliff,
bold serif title centered at the top, subtle tagline at bottom in small caps,
highly detailed, 35mm film grain.
Poin-poin penting:
image_size=4K+aspect_ratio=2:3≈ 3840×5760quality=highsangat krusial untuk kejelasan teks; pengaturan rendah dapat menyebabkan bentuk huruf tidak rapi.timeoutharus ≥ 360 detik, karena pembuatan gambar 4K bisa memakan waktu 3–5 menit.
5.2 Alur Kerja B: Inpainting Mask (Ganti Latar Belakang/Perbaikan Detail)
Tujuan: Mengganti latar belakang putih polos pada gambar produk cangkir kopi menjadi "meja bermotif marmer", tanpa mengubah cangkir kopi dan bayangannya.
[LoadImage: coffee_cup.png] [LoadImage: coffee_cup_mask.png]
│ │
▼ ▼
[Luck gpt-image-2]
├── prompt = Replace the background with a luxurious
│ white marble countertop, soft natural
│ window light from the left
├── image_1 = ← coffee_cup.png
├── mask = ← coffee_cup_mask.png (putih=area latar)
├── image_size = 2K
├── quality = high
│
▼
[SaveImage]
Aturan kunci Mask:
- Gambar Mask harus memiliki lebar dan tinggi yang sama persis dengan
image_1. - Putih (255,255,255) = Area yang akan diedit.
- Hitam (0,0,0) = Area yang pikselnya dipertahankan.
- Abu-abu di antara keduanya = Pencampuran proporsional (bisa digunakan untuk feathering tepi).
💡 Tips Presisi: Gunakan Gaussian blur 3–5 px pada tepi Mask untuk menghindari efek jahitan "seperti stiker". gpt-image-2 sendiri sangat ramah terhadap transisi abu-abu, sehingga sangat cocok untuk penggantian latar belakang pada foto produk komersial.
5.3 Alur Kerja C: Mode Ekonomis untuk Batch 100 Konsep
Tujuan: Mendesain 100 konsep pakaian untuk satu karakter, dengan biaya sekitar $0,03 per gambar, menjaga total biaya di kisaran $3.
[TextFileReader: 100 petunjuk]
│
▼ (loop/antrean)
[Luck gpt-2.0 all]
├── base_url = https://vip.apiyi.com/v1 ← gunakan jalur konkurensi tinggi
├── api_key = sk-xxxx
├── endpoint = chat_completions
├── model = gpt-image-2-all
├── timeout = 180
└── max_retries = 3
│
▼
[SaveImage: filename_prefix = concept_###]
Tiga alasan mengapa node Luck gpt-2.0 all paling cocok untuk skenario ini:
- Penagihan per gambar: Sekitar $0,03/gambar, lebih mudah dianggarkan daripada penagihan berbasis token.
- Ramah petunjuk bahasa Mandarin: Konsep sering menggunakan istilah seperti "Hanfu modifikasi" atau "Cyberpunk", dan node ini memiliki stabilitas yang lebih tinggi.
- Peralihan endpoint: Mode
chat_completionsmemiliki toleransi yang lebih baik terhadap petunjuk yang panjang.
🎯 Stabilitas Batch: Saat menjalankan batch, ubah
base_urlkevip.apiyi.com, aturmax_retrieske 3, dantimeoutke 180 detik. Jalur VIP APIYI (apiyi.com) akan secara otomatis mendistribusikan fluktuasi singkat 429/5xx ke jalur cadangan, sehingga tugas panjang tidak mudah terhenti di tengah jalan.
VI. Teknik Lanjutan Integrasi ComfyUI dengan gpt-image-2
6.1 Pipeline Campuran: gpt-image-2 untuk Subjek + Model Lokal untuk Gaya
gpt-image-2 unggul dalam "komposisi kompleks + tata letak teks", namun kurang optimal untuk gaya anime, pixel art, atau gaya seniman tertentu dibandingkan SDXL / Flux. Pipeline campuran yang direkomendasikan:
[Luck gpt-image-2] → Menghasilkan komposisi subjek (dengan teks, dengan Logo)
↓
[VAE Encode] → Konversi kembali ke latent
↓
[KSampler: Flux/SDXL + LoRA] → Transfer gaya / perbaikan ketajaman
↓
[Upscaler: 4x-UltraSharp] → Upsampling lebih lanjut ke 8K
Pendekatan ini memanfaatkan kemampuan gpt-image-2 dalam "menulis teks" sekaligus kebebasan "gaya" dari model lokal, sehingga kualitas hasil akhir biasanya satu tingkat lebih tinggi.
6.2 Konsistensi Multi-Gambar Referensi: Produk / Karakter Tetap Stabil
Aktifkan 5 input gambar referensi pada Luck gpt-image-2 untuk meningkatkan konsistensi karakter atau produk secara signifikan:
| Posisi Gambar Referensi | Saran Penggunaan |
|---|---|
| image_1 | Gambar subjek depan yang jelas |
| image_2 | Samping/belakang subjek |
| image_3 | Detail close-up (Logo, tekstur) |
| image_4 | Referensi suasana latar |
| image_5 | Referensi warna/cahaya |
Tekankan pada petunjuk untuk "mempertahankan identitas karakter dari image_1" atau "menggunakan arah cahaya dari image_4" agar hasilnya sangat stabil.
6.3 Konsistensi Batch: Menghasilkan 8 Gambar Seri Sekaligus
gpt-image-2 dapat mengembalikan hingga 8 gambar dengan subjek yang konsisten dalam satu kali pemanggilan. Di node Luck gpt-image-2, atur parameter n ke 8 (pada beberapa versi disebut batch_size):
Luck gpt-image-2
├── prompt = character turnaround sheet of a cyberpunk girl,
│ 8 different poses, same outfit, same face,
│ white background, character sheet layout
└── n = 8
Cocok untuk:
- Lembar putaran karakter (8 sudut pandang)
- Varian produk (8 warna/kemasan)
- Storyboard (8 frame)
6.4 Mengekspos Alur Kerja ComfyUI sebagai API
Jika Anda menggunakan ComfyUI sebagai "server pribadi" untuk dipanggil oleh frontend, output dari node Comfyui-Luck-gpt2.0 dapat langsung dikonsumsi oleh endpoint /prompt ComfyUI. Dengan menggunakan multi-jalur APIYI (apiyi.com) sebagai backend, seluruh alurnya menjadi:
Frontend Anda → ComfyUI HTTP API → Node Luck gpt-image-2
↓
api.apiyi.com / vip.apiyi.com
↓
OpenAI gpt-image-2
Ini adalah jalur tercepat untuk membungkus "Alur Kerja ComfyUI" menjadi "API Gambar Eksternal".
VII. FAQ: Pertanyaan Umum Seputar Integrasi ComfyUI dengan gpt-image-2
Q1: Node sudah terinstal, tapi Luck gpt-image-2 tidak muncul saat dicari di kanvas?
Periksa empat hal berikut:
- Pastikan direktori
ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0/sudah ada. - Pastikan semua dependensi di
requirements.txtterinstal dengan sukses (perhatikanrequestsdanPillow). - Periksa apakah ada pesan error
ImportErrorberwarna merah saat ComfyUI dijalankan di konsol. - Apakah Anda sudah melakukan "restart total" pada ComfyUI? (Menekan Ctrl+R pada browser tidak cukup).
Q2: Muncul pesan 401 Unauthorized atau Invalid API key?
99% masalahnya ada pada Key atau base_url:
- Key harus menyertakan awalan
sk-secara lengkap. base_urlharus diakhiri dengan/v1(jangan hanya menulishttps://api.apiyi.com).- Jangan menambahkan kata
Bearersecara manual di depan Key, node akan menambahkannya secara otomatis.
Q3: Muncul pesan 429 Too Many Requests?
Ini berarti limit rate tercapai, berikut solusinya:
- Jangka pendek: Atur
max_retrieske angka 3 atau lebih agar node menunggu dan mencoba kembali secara otomatis. - Jangka panjang: Ubah
base_urldariapi.apiyi.comkevip.apiyi.comataub.apiyi.com. Keduanya adalah jalur untuk konkurensi tinggi atau jalur cadangan.
Tabel ringkasan kode error:
| Kode Error | Arti | Penanganan |
|---|---|---|
| 401 | Key tidak valid | Salin ulang, periksa awalan sk- |
| 403 | Izin tidak cukup | Pastikan model sudah diaktifkan di dasbor APIYI |
| 408 | Timeout | Atur timeout ke 360 detik |
| 429 | Limit rate | Pindah ke jalur vip + tingkatkan retries |
| 500/502 | Gangguan server | Coba otomatis 3 kali, atau pindah ke jalur b |
Q4: Render 4K selalu mengalami timeout?
- Atur
timeoutke 480 detik (gpt-image-2 4K + quality=high terkadang memakan waktu hingga 6 menit). max_retries=2sudah cukup, terlalu banyak retry akan mengakibatkan akumulasi waktu yang lama.- Jika koneksi internet lambat, gunakan
image_size=2Klalu gunakan node Upscaler untuk memperbesar ke 4K agar terasa lebih cepat.
Q5: Hasil Mask tidak akurat setelah ditempelkan?
- Pastikan Mask dan gambar asli memiliki lebar dan tinggi yang sama, tanpa pergeseran piksel.
- Pastikan Mask murni hitam putih, jangan gunakan saluran transparan (alpha channel).
- Area putih harus benar-benar (255,255,255), jangan gunakan abu-abu muda.
- Anda bisa menambahkan node
ImageThresholdsebelum node Mask untuk memaksa binerisasi.
Q6: Apakah bisa digunakan sepenuhnya secara offline?
Tidak bisa. gpt-image-2 adalah model cloud OpenAI, jadi harus diakses melalui gateway. Namun, Anda bisa menggunakan tiga jalur keluar dari APIYI apiyi.com untuk mendapatkan "pseudo-high availability": sistem akan otomatis berpindah saat situs utama mengalami gangguan, sehingga terasa seperti deployment lokal.
Q7: Teks pada prompt bahasa Mandarin sering berantakan?
- Node standar (Luck gpt-image-2) lebih unggul dalam tipografi bahasa Inggris.
- Untuk prompt bahasa Mandarin, disarankan menggunakan node alternatif (Luck gpt-2.0 all) yang menggunakan
gpt-image-2-all, pemahaman bahasa Mandarinnya lebih stabil. - Jika harus menggunakan node standar + bahasa Mandarin, tulis langsung di prompt:
render Chinese text "你好世界"daripada membiarkan model "menebak" apa yang harus ditulis.
Q8: Bagaimana cara estimasi biayanya?
- Node standar (gpt-image-2): Dihitung berdasarkan token, satu gambar 2K sekitar $0,08–0,15, 4K high sekitar $0,25–0,40.
- Node alternatif (gpt-image-2-all): Dihitung per gambar, sekitar $0,03/gambar.
- Disarankan untuk mengaktifkan "Batas Penggunaan Harian" di dasbor APIYI apiyi.com, coba jalankan 50–100 gambar sebagai tolok ukur.
VIII. Kesimpulan Integrasi ComfyUI dengan gpt-image-2
Mengintegrasikan gpt-image-2 ke dalam ComfyUI pada dasarnya memberi Anda model cloud kelas atas dan node lokal yang presisi dalam satu kanvas lokal. Setelah menyelesaikan panduan ini, Anda seharusnya sudah:
- ✅ Menginstal plugin Comfyui-Luck-gpt2.0 dan mendapatkan dua node baru.
- ✅ Mendapatkan Key dari dasbor APIYI
apiyi.comdan menyelesaikan konfigurasibase_url/api_key. - ✅ Menjalankan alur kerja teks-ke-gambar minimal untuk memastikan koneksi berhasil.
- ✅ Menguasai kombinasi parameter 1K/2K/4K, 15 rasio aspek, empat tingkat kualitas, dan tiga format (PNG/JPEG/WebP).
- ✅ Menjalankan setidaknya satu dari tiga alur kerja praktis: teks-ke-gambar 4K, Mask inpainting, atau mode batch ekonomis.
Nilai terbesar dari integrasi ComfyUI dengan gpt-image-2 adalah mengubah "model gambar kelas atas OpenAI" menjadi "node biasa di kanvas ComfyUI". Anda tidak perlu lagi berpindah-pindah antara browser dan alat lokal; semua pipeline dapat dirangkai dalam satu alur kerja: gpt-image-2 menghasilkan subjek → SDXL untuk gaya → Upscaler untuk upsampling → SaveImage untuk menyimpan.
🎯 Saran langkah selanjutnya: Disarankan untuk mengajukan Key pengujian di platform APIYI
apiyi.com(bisa dengan saldo kecil), jalankan gambar pertama Anda mengikuti alur kerja minimal di §3.5, lalu kembangkan ke tiga alur kerja praktis di §5. Jika ada masalah parameter, periksa kembali tabel ringkasan di §4; jika ada kode error, lihat FAQ di §7. Jika membutuhkan contoh alur kerja JSON yang lebih kompleks, silakan merujuk ke kolom ekosistem ComfyUI di situs dokumentasi resmi APIYIdocs.apiyi.com.
Sekarang, Anda memiliki solusi integrasi ComfyUI gpt-image-2 yang lengkap dan siap untuk digunakan dalam produksi. Selamat berkarya di kanvas ComfyUI!
Penulis: Tim Teknis APIYI
Sumber Daya Terkait:
- Repositori Plugin: github.com/luckdvr/Comfyui-Luck-gpt2.0
- Situs Resmi APIYI: apiyi.com
- Dokumentasi APIYI: docs.apiyi.com
- Situs Utama APIYI: api.apiyi.com (Cadangan: vip.apiyi.com / b.apiyi.com)
