Nano Banana Expert API documentation

Authorization: Bearer nb_your_api_key_here

{
  "bananas": 1250,
  "generation_coupons": 2,
  "coupon_scope": { "model": "gpt2", "quality": "low", "resolution": "1k" }
}

curl -H "Authorization: Bearer nb_your_key" \
  https://nanobanana.expert/api/v1/balance

const res = await fetch('https://nanobanana.expert/api/v1/balance', {
  headers: { 'Authorization': 'Bearer nb_your_key' }
});
const { bananas, generation_coupons } = await res.json();
console.log(`Balance: ${bananas} bananas`);

{
  "image_url": "https://...",
  "bananas_spent": 42,
  "used_coupon": false,
  "seed": 1234567890,
  "generation_id": "uuid",
  "provider_chain": ["primary"],
  "transparent_background": false
}

curl -X POST https://nanobanana.expert/api/v1/generate \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a banana in space, cinematic lighting",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "output_format": "png",
    "transparent_background": true
  }'

const res = await fetch('https://nanobanana.expert/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer nb_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'a banana in space, cinematic lighting',
    aspect_ratio: '16:9',
    resolution: '1k',
    preferred_provider: 'stable', // economy / stable / reliable
  }),
});
const { image_url, bananas_spent } = await res.json();
console.log('Generated:', image_url);

curl -X POST https://nanobanana.expert/api/v1/generate \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "make the lighting cinematic, keep the subject",
    "reference_images": ["https://example.com/photo.jpg"],
    "resolution": "2k"
  }'

// Option 1 — public URL (recommended, no body size limits)
await fetch('https://nanobanana.expert/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer nb_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'restore colors, increase sharpness',
    reference_images: ['https://example.com/photo.jpg'],
    resolution: '2k',
  }),
});

// Option 2 — base64 data URL (image/png|jpeg|webp|gif)
const dataUrl = 'data:image/jpeg;base64,/9j/4AAQSk...';
await fetch('https://nanobanana.expert/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer nb_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'restore colors, increase sharpness',
    reference_images: [dataUrl],
  }),
});

curl -X POST https://nanobanana.expert/api/v1/generate \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraft_bg",
    "reference_images": ["https://example.com/photo.jpg"]
  }'

{
  "id": "uuid",
  "status": "processing",
  "bananas_spent": 503,
  "balance": 12497
}

{
  "id": "uuid",
  "status": "success",            // processing | success | failed
  "video_url": "https://...mp4",  // only when status = success
  "model": "kling30",
  "mode": "frames",
  "prompt": "the camera slowly orbits the product",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "auto",
  "width": 720,
  "height": 960,
  "bananas_spent": 503,
  "error": null,
  "moderation": false,
  "created_at": "2026-09-25T12:00:00Z"
}

curl -X POST https://nanobanana.expert/api/v1/video \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling30",
    "prompt": "the camera slowly orbits the product, soft studio light",
    "first_frame": "https://example.com/product.jpg",
    "duration": 5,
    "resolution": "720p"
  }'

curl https://nanobanana.expert/api/v1/video/VIDEO_ID \
  -H "Authorization: Bearer nb_your_key"

const headers = {
  'Authorization': 'Bearer nb_your_key',
  'Content-Type': 'application/json',
};

const start = await fetch('https://nanobanana.expert/api/v1/video', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    model: 'seedance25',
    prompt: 'a woman in @Image1 walks through a neon-lit street',
    reference_images: ['https://example.com/character.jpg'],
    duration: 5,
    aspect_ratio: '9:16',
  }),
});
const { id } = await start.json();

let video;
do {
  await new Promise(r => setTimeout(r, 8000));
  video = await (await fetch(`https://nanobanana.expert/api/v1/video/${id}`, { headers })).json();
} while (video.status === 'processing');

console.log(video.status === 'success' ? video.video_url : video.error);

curl -X POST https://nanobanana.expert/api/v1/video \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling30",
    "first_frame": "https://example.com/hero.jpg",
    "shots": [
      { "prompt": "close-up, the hero looks at the camera", "duration": 3 },
      { "prompt": "wide shot, the hero turns and walks away", "duration": 4 }
    ]
  }'

{
  "generations": [
    {
      "id": "uuid",
      "prompt": "a banana in space",
      "image_url": "https://...",
      "model": "nb21",
      "seed": 1234567890,
      "created_at": "2026-03-04T12:00:00Z"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

curl "https://nanobanana.expert/api/v1/history?limit=10&offset=0" \
  -H "Authorization: Bearer nb_your_key"

curl -X POST https://nanobanana.expert/api/v1/keys \
  -H "Authorization: Bearer nb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Bot"}'

curl -X DELETE "https://nanobanana.expert/api/v1/keys?id=key-uuid-here" \
  -H "Authorization: Bearer nb_your_key"