Nano Banana 2

Endpoints

Base URL: https://01router.com/api/v1

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer sk_xxxxxxxxxxxxxxxx

Request body

input fields

Unified parameters work on every provider; some providers support a narrower range — check the quote endpoint or the playground.

Example request

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "provider": "fal",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}'

# poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"

Response

Pass the model id, its unified input parameters and optionally a provider slug. The response returns immediately with the task id; image models on synchronous providers may already be succeeded.

{
  "id": "gen_6f1c…",
  "object": "generation",
  "model": "nano-banana-2",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "…",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-23T08:00:00.000Z",
  "completed_at": null
}

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl https://01router.com/api/v1/generations/gen_6f1c… -H "Authorization: Bearer $API_KEY"

{ "id": "gen_6f1c…", "model": "nano-banana-2", "status": "succeeded", "outputs": ["https://…"], … }

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl https://01router.com/api/v1/quote -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"…","aspect_ratio":"1:1","resolution":"1K","num_images":1}}'