GetRun by Getcore API Documentation

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.

POSThttps://getrun.id/v1/tasks
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

NameTypeRequiredDescriptionExample
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.

GEThttps://getrun.id/v1/tasks/{task_id}

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

StatusKeterangan
queuedTugas sedang diantrikan.
processingSedang diproses.
succeededBerhasil.
failedGagal — lihat error detail, tidak ditagih.
Output bertipe 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.

On this page
1 · Create a task Input parameters 2 · Poll the result Status values Best practices
Pricing summary
Nano Banana 2.1
Rp490 / gambar
  • Harga jelas, pembayaran mudah.
  • Transparan, tanpa biaya tersembunyi.
  • Hemat 66% dibanding harga pembanding.
Try in Playground ↗

Eksperimen model ini langsung di Playground untuk hasil instan.

Model details
Model IDgoogle-flow/nano-banana-2-1
Modalityimage
Typical latency±10–120 detik
Output typeimage/jpeg
API versionv1
Need help?

Lihat daftar error umum di Error handling atau hubungi support@getcore.id.