API Krea 3 sedang dalam tahap akses awal. Hanya workspace yang tergabung dalam beta Krea 3 yang dapat memanggilnya. Untuk meminta akses, hubungi sales@krea.ai.
Endpoint
Endpoint ini menggunakan siklus hidup job standar: endpoint mengembalikan
job_id, lalu Anda melakukan polling ke GET /jobs/{job_id} (atau menggunakan webhook) hingga job selesai. Gambar output ada di result.urls[0].
Mulai cepat: edit gambar pertama Anda
Semua permintaan memerlukan token Bearer. Lihat API Keys & Billing jika Anda belum memilikinya.1
Unggah referensi
POST /assets dengan gambar input Anda. Respons mengembalikan image_url. Anda juga dapat langsung meneruskan URL gambar eksternal atau data URI base64 di image_urls.2
Buat edit
POST /generate/image/krea/krea-3 dengan prompt dan referensi Anda. Simpan job_id dari respons.3
Ambil hasilnya
Lakukan polling ke
GET /jobs/{job_id} hingga status bernilai completed. Output ada di result.urls[0].Parameter
Dengan
width dan height, output dibulatkan ke rasio aspek terdekat yang didukung dan kanvas 1k atau 2k. Dimensi piksel yang persis tidak dijamin.Menggunakan ulang seed tidak menjamin hasil yang identik, karena tahap perluasan prompt dapat berbeda di setiap proses.Mode berpikir
Sebelum menghasilkan gambar, Krea 3 menafsirkan prompt Anda.thinking_mode menentukan seberapa banyak perencanaan yang dilakukannya.
Jika Anda tidak menyertakan
thinking_mode, API menggunakan fast. Kedua mode mendukung regional_edit.
Edit regional
Denganregional_edit: true, Krea 3 hanya membuat ulang bagian gambar yang perlu diubah. Semua bagian lain tetap persis seperti semula, sehingga Anda dapat mengedit gambar yang sama berulang kali tanpa kehilangan kualitas.
Gunakan untuk edit lokal ketika bagian lain gambar harus tetap sama hingga ke tingkat piksel: mengubah warna atau mengganti objek, menambah atau menghapus elemen, memperbaiki detail, atau mengubah teks pada papan tanda. Ini adalah cara aman untuk merangkai edit pada output terbaru.
Jangan gunakan untuk edit global yang perlu merender ulang seluruh gambar: mengubah gaya, mengubah pencahayaan, mengganti musim atau waktu, mengubah pembingkaian, atau menggabungkan beberapa gambar menjadi adegan baru. Edit biasa merender ulang seluruh gambar, sehingga artefak dapat menumpuk jika Anda terus mengedit output terbaru.
Edit regional memerlukan setidaknya satu gambar di image_urls.
Menulis prompt
Krea 3 adalah editor yang mengikuti instruksi. Tuliskan edit Anda dalam bahasa sehari-hari:- Awali dengan perubahan yang diinginkan. Tambahkan hanya detail yang membantu mewujudkannya.
- Tutup dengan satu kalimat pelestarian jika bagian lain gambar harus tetap sama. Jangan mendaftar semua hal yang harus tetap sama.
- Jika prompt menggunakan lebih dari satu gambar, sebut setiap gambar berdasarkan isinya. Contoh: “Pakaikan sepatu sneaker dari gambar kedua pada orang di gambar pertama.”
Referensi gambar
- Krea 3 menggunakan setiap referensi pada resolusi saat diunggah. Referensi yang lebih besar dari 4 MP akan diubah ukurannya menjadi 4 MP.
- Sekitar 1 MP sudah cukup untuk sebagian besar edit. Jangan memperbesar resolusi referensi sebelum mengirimnya.
- Jika detail halus penting (teks kecil, logo, kain, wajah dalam bidikan lebar), kirim versi gambar dengan resolusi tertinggi yang Anda miliki.
- Dengan lima referensi atau lebih dalam satu permintaan, setiap referensi diubah ukurannya menjadi maksimal 1536 px pada sisi terpanjangnya. Untuk referensi dengan detail penuh, kirim empat referensi atau kurang.
Zero Data Retention
Krea 3 mendukung Zero Data Retention untuk workspace enterprise. Kirim headerX-Api-Zero-Data-Retention: 1. Dengan Zero Data Retention:
- Setiap gambar di
image_urlsharus berupa data URI base64. thinking_modedapat bernilaifastatauhigh.- Satu permintaan dapat menggunakan maksimal 4 referensi gambar.
Harga
Harga per gambar bergantung pada resolusi output, mode berpikir, dan referensi gambar.Terkait
Siklus hidup job
Status job, polling, dan hasil.
Webhooks
Dapatkan notifikasi saat job selesai alih-alih melakukan polling.