SEEDANCE 2.5 IS NOW LIVE!

GENERATE YOUR VIDEOS WITH UNLIMITED SEEDANCE 2.5 TODAY.

NO EXTRA SUBSCRIPTION
REVIRAL
Get API key
Browse API docs

Models · Image

Nano Banana API

Was this page helpful?

Nano Banana is good for generating still images when you need its listed output sizes and aspect ratios.

Pricing

Default example: 1 image at 1K costs 3 credits, or $0.06 at the shared USD reference.

ResolutionUnitCreditsUSD
1KPer image3 cr$0.06

Accepted inputs

Kind
image
Durations
Not applicable
Resolutions
1K
Aspect ratios
1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
Defaults
1K · 1:1 · count 1

Sample request

The request uses the current default settings for this model and the public GenerateMediaRequest schema.

curl -X POST "https://reviral.ai/api/v1/generate-media" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Idempotency-Key: first-video" \
  -H "Content-Type: application/json" \
  --data '{"model":"nano-banana","prompt":"A clean product photograph on a warm neutral background","size":"1K","aspectRatio":"1:1","count":1,"maxCredits":3}'

Response and output

Accepted job
{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "nano-banana",
    "creditsCharged": 3,
    "status": "queued",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
  }
}
Ready job
{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "nano-banana",
    "creditsCharged": 3,
    "status": "ready",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
    "outputUrls": [
      "https://reviral.ai/signed-output"
    ]
  }
}

Error cases

  • 404 model_not_available: the ID is no longer in the live catalog.
  • 409 price_changed: the current cost differs from maxCredits.
  • 422 validation_error: duration, resolution, aspect ratio, size, or count is not accepted.
  • 429 rate_limit_exceeded: wait for Retry-After before retrying.

Frequently asked questions

How much does the Nano Banana API cost?
The default 1 image at 1K costs 3 credits, about $0.06 at the shared USD reference. Read the live models endpoint before submitting.
Which inputs does Nano Banana accept?
It accepts a prompt, listed size and aspect ratio, and an image count from 1 to 4 subject to the model limit. Reference inputs are not available through this v1 endpoint.
How do I retrieve Nano Banana output?
Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.