Docs / image / Nano Banana 2.1
Nano Banana 2.1 online
Nano Banana 2.1 untuk membuat dan mengedit gambar, dengan hingga 10 gambar referensi. Satu gambar resolusi native per generate.
Rp Rp490 / gambar
Rp1.440 −66%
⏱ ±10–120 detik perkiraan waktu
google-flow/nano-banana-2-1 model id
Teks ke gambarEdit gambarHingga 10 referensi5 rasio aspek
1 · Create a task
Kirim permintaan untuk membuat tugas generasi image. Wajib header Idempotency-Key. Saldo direservasi Rp490; task gagal tidak ditagih.
curl -X POST https://getrun.id/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: my-task-001" \
-H "Content-Type: application/json" \
-d '{
"model": "google-flow/nano-banana-2-1",
"input": {
"prompt": "A yellow ceramic teapot on a blue table, soft morning window light, editorial product photograph.",
"aspect_ratio": "1:1"
}
}'const res = await fetch('https://getrun.id/v1/tasks', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Idempotency-Key': 'my-task-001',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "google-flow/nano-banana-2-1",
"input": {
"prompt": "A yellow ceramic teapot on a blue table, soft morning window light, editorial product photograph.",
"aspect_ratio": "1:1"
}
}),
});
const task = await res.json();import requests
res = requests.post(
"https://getrun.id/v1/tasks",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "my-task-001",
},
json={
"model": "google-flow/nano-banana-2-1",
"input": {
"prompt": "A yellow ceramic teapot on a blue table, soft morning window light, editorial product photograph.",
"aspect_ratio": "1:1"
}
},
)
task = res.json()Input parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
seed |
integer | No | (min 0, max 2147483647) | — |
prompt |
string | Yes | (max 20000 chars) | A yellow ceramic teapot on a blue table, soft |
image_urls |
array | No | Optional reference images for editing (up to 10, maximum 20 MB each). | — |
aspect_ratio |
string | No | Opsi: 16:9 4:3 1:1 3:4 9:16 |
1:1 |
2 · Poll the result
Ambil status tugas hingga selesai — poll tiap 2–5 detik.
Respons saat sukses:
{
"id": "task_9f2c…",
"status": "succeeded",
"model": "google-flow/nano-banana-2-1",
"price": {
"currency": "IDR",
"estimated": 490,
"reserved": 490,
"final": 490
},
"output": {
"urls": [
"https://storage.getcore.id/outputs/task_9f2c…/0.jpeg"
],
"expires_at": "(7 hari setelah selesai)"
}
}
Status values
| Status | Keterangan |
|---|---|
queued | Tugas sedang diantrikan. |
processing | Sedang diproses. |
succeeded | Berhasil. |
failed | Gagal — lihat error detail, tidak ditagih. |
image/jpeg, dilayani dari CDN kami dan berlaku 7 hari — salin ke penyimpananmu sendiri untuk jangka panjang.Best practices
Bila generation gagal, task berstatus failed dengan error.code ternormalisasi (mis. moderation_blocked, upstream_error) dan price.final = 0 — saldo dikembalikan otomatis. Daftar lengkap kode error ada di Error handling. Selalu kirim Idempotency-Key unik per tugas agar retry aman.
Coba tanpa kode: jalankan model ini langsung dari Playground atau lihat di API Market.
