Skip to main content
Krea 3 adalah model pengeditan gambar yang cepat. Model ini mengikuti instruksi dalam bahasa sehari-hari: Anda cukup menyebutkan apa yang perlu diubah dan apa yang harus tetap sama, lalu Krea 3 menghasilkan editnya dalam hitungan detik. Anda juga dapat menggunakannya untuk menghasilkan gambar dari teks.
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].
Simpan token API Anda di server. Jangan pernah menyertakannya dalam kode sisi klien.

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

Dengan regional_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.
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 header X-Api-Zero-Data-Retention: 1. Dengan Zero Data Retention:
  • Setiap gambar di image_urls harus berupa data URI base64.
  • thinking_mode dapat bernilai fast atau high.
  • 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.