API docsAPI reference

Nano Banana 2.1 · 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.

GET/api/v1/generations/{id}Bearer API key

nano-banana-2.1Image · GoogleModel details & pricing

Endpoints for this model

POST/generationsCreate a generation POST/images/generationsOpenAI-compatible images GET/generations/{id}Get the result POST/generations/{id}/cancelCancel a task POST/quoteQuote GET/models/{slug}Get one model

Parameter scope

Select a provider to see its effective parameter limits. Automatic routing chooses a provider that supports your input. Examples include defaults and required inputs; replace example media URLs with accessible files.

Request

cURL

curl 'https://01router.com/api/v1/generations/gen_example' \
  -H "Authorization: Bearer $API_KEY"

Input parameters

Query / path parameters

id string · pathRequired: Generation ID returned by the create request.

Response example

200 · application/json

{
  "id": "gen_example",
  "object": "generation",
  "model": "nano-banana-2.1",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/result.png"
  ],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Responses are illustrative. IDs, usage, prices and results depend on the actual request.

Response fields

id string: Generation ID returned by the create request.
object "generation": generation
model string: Model slug from the catalog. Project keys may use a project-specific model slug.
type video | image | audio | chat
provider string: Optional provider slug. Omit for automatic routing; project settings may pin the provider.
status string: queued / processing / succeeded / failed. Stop polling on succeeded or failed.
input object: Model-specific input object. See the selected model reference for required fields, defaults and limits.
outputs string[]: Result file URLs. Empty until available; download promptly because URLs may expire.
error string | null: Error message on failure; null otherwise.
credits number: Credits charged for this generation; zero after a refund.
price_usd number: Price of this generation in USD; zero after a refund.
created_at string: Creation time in ISO 8601 format.
completed_at string | null: Completion time in ISO 8601 format, or null while running.

Usage notes

Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.

Use with AI

Give your coding assistant the documentation index or the full API reference, including live model parameters.

llms.txt llms-full.txt This page as Markdown