Nano Banana Pro API

Generate images with complex compositions and precise typography. Prioritises detail and prompt understanding over speed.

Google · nano-banana-pro

Text to image

Generate images with complex compositions and precise typography. Prioritises detail and prompt understanding over speed.

Put a prompt and "model": "nano-banana-pro" on an image clip, and the render generates it and edits it into the video. To generate it on its own, send the same asset to the generate endpoint.

Built forDetailed compositions · Images with precise typography · Final creative

Nano Banana Pro output: A ceramic vase of dried flowers on a brick-red backdrop
Nano Banana Pro “A ceramic vase of dried flowers on a brick-red backdrop”
Technical specifications
InputText prompt
OutputImage
Resolution1K, 2K, 4K
Aspect ratiosauto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
SeedSet a seed for repeatable results
{
  "asset": {
    "type": "image",
    "prompt": "A ceramic vase of dried flowers on a brick-red backdrop",
    "model": "nano-banana-pro",
    "options": {
      "aspectRatio": "4:3",
      "resolution": "1K"
    }
  },
  "length": 5
}
Example request to the generate endpoint.

Options

OptionValuesDefault
aspectRatioauto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:161:1
resolution1K, 2K, 4K1K
seedinteger
systemPromptstring

Pricing

Generation is paid in credits from the same balance as rendering, at what the model's provider charges plus a small margin. See AI generation pricing.

ModeCharged perPrice changes withLength a quote assumes without one
Text to imageImageResolution: 1K (default), 2K, 4K—

Get a quote

POST /generate/quote takes the same body as the generate endpoint and returns what that generation would cost. Nothing is generated, reserved or charged.

curl -X POST \
     -H "Content-Type: application/json" \
     -H "x-api-key: $SHOTSTACK_API_KEY" \
     -d '{
       "asset": {
         "type": "image",
         "prompt": "A ceramic vase of dried flowers on a brick-red backdrop",
         "model": "nano-banana-pro",
         "options": {
           "aspectRatio": "4:3",
           "resolution": "1K"
         }
       },
       "length": 5
     }' \
     https://api.shotstack.io/edit/stage/generate/quote

The response gives credits, the price of that request, and ceiling, which is true when the request has no length for a model charged by length, so the price is an estimate. Prices follow the providers, so ask again rather than storing one.

How it compares

Nano Banana Pro beside the other models in Shotstack that make the same thing.

ModelBest forModesMax resolutionAspect ratiosReference imagesSeedCharged per
Nano Banana ProComplex compositions and precise typography, over speedText to image4K10—YesImage
Nano Banana 2Fast iteration, accurate text, product and campaign visualsText to image, Image to image4K14Up to 14YesImage
GPT Image 2.5 SunburstHighly detailed images that follow complex prompts; slowerText to image, Image to image4K10Up to 16—Image
FLUX SchnellQuick, low-cost drafts and illustrationsText to image————Image, fixed price

Questions

Do I need an account with the model provider?
No. Generation runs on your Shotstack API key and is paid in credits from the same balance as rendering, so there is no separate account to open and nothing extra to integrate.
Do I pay again for the same asset?
No. Every generated file is stored against your account. An asset with the same type, model, prompt, options and length as one generated before reuses the stored file at no charge.
What happens if a generation fails?
A failed generation isn't charged. If a render fails after some of its assets were generated, those assets are kept, and rendering again reuses them at no charge.
Can I generate an asset without rendering a video?
Yes. POST the asset to the generate endpoint and you get back a URL to the file, to check it before you render, to reuse it across many edits, or to use it outside Shotstack.

Start free

  • 10 free credits to start
  • No credit card required