API Nano Banana 2.1

Referensi API lengkap untuk model pembuatan gambar dari teks dan pengeditan gambar Nano Banana 2.1.

Varian Model

API ini mendukung dua varian model:

Perbandingan Singkat

Rasio Aspek yang Didukung

Kedua model mendukung 14 rasio aspek:

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

Tentukan rasio menggunakan nilai numerik width dan height yang terpisah; misalnya, width: 16 dan height: 9 memilih 16:9. Nilai ini menyatakan rasio, bukan dimensi keluaran dalam piksel.

Nano Banana 2.1 (Pembuatan Gambar dari Teks)

Titik Akhir

POST /api/v1/image/task

Autentikasi

Authorization: Bearer YOUR_API_KEY

Parameter Permintaan

Wajib

Catatan: Rasio width:height harus salah satu dari: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1.

Opsional

Contoh Permintaan

javascriptSalin
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2.1 Edit (Pengeditan Gambar)

Titik Akhir

POST /api/v1/image/task

Parameter Permintaan

Wajib

Catatan: Rasio width:height harus salah satu dari 14 rasio yang didukung dan tercantum di atas.

Opsional

Contoh Pengeditan Satu Gambar

javascriptSalin
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

Contoh Komposisi Beberapa Gambar

javascriptSalin
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

Catatan Penagihan: Gambar referensi dikenakan biaya per gambar mulai dari gambar pertama. Setiap opsi pencarian yang diaktifkan menambahkan biaya tetap tersendiri per pembuatan, terlepas dari jumlah gambar. Lihat harga terkini untuk mengetahui tarifnya.

Format Respons

Respons Awal

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

Respons Pemeriksaan Berkala

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

Respons Berhasil

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

Nilai Status

• submitted: Tugas diterima
• processing: Tugas sedang berjalan
• succeed: Tugas berhasil diselesaikan
• failed: Tugas gagal

Praktik Terbaik

Tips Pembuatan Gambar dari Teks

1. Deskripsikan Gambar: Sertakan subjek, pencahayaan, dan komposisi dalam prompt.
2. Pilih Resolusi: Kirim 1k, 2k, atau 4k dalam setiap permintaan.
3. Pilih Rasio Aspek: Kirim nilai width dan height yang sesuai dengan salah satu dari 14 rasio yang didukung.
4. Pilih Opsi Pencarian: Jangan sertakan salah satu penanda pencarian untuk menggunakan nilai bawaannya, yaitu false; atur ke true saat diperlukan.

Tips Pengeditan Gambar

1. Sediakan Gambar Referensi: Sertakan 1 hingga 14 URL gambar yang dapat diakses dalam image_url_list.
2. Deskripsikan Pengeditan: Nyatakan apa yang harus diubah atau dipertahankan dalam prompt.
3. Pilih Pengaturan Keluaran: Berikan nilai wajib resolution, width, dan height.
4. Pilih Opsi Pencarian: Pencarian web dan pencarian gambar dapat diaktifkan secara terpisah.