Skip to main content
POST
/
kyyReactApiServer
/
v1
/
banana
/
images
curl --request POST \
--url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/banana/images \
--header 'Authorization: Bearer {{key}}' \
--header 'Content-Type: application/json' \
--data '{
"model": "nano-banana-2",
"prompt": "A cute orange cat sitting on a windowsill looking at the scenery outside",
"resolution": "2k",
"size": "16:9",
"image_urls": []
}'

{
    "id": "abc123def456",
    "object": "image",
    "created": 1761635478,
    "model": "nano-banana-2",
    "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://docs.globalaiopc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Create Image Generation Task

Use the Nano Banana API to create high-quality AI image generation tasks with support for multiple models and resolution options.

​
Authentication

All requests require a Bearer token in the request header: 
Authorization: Bearer {{key}}

​
Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

​
Request Parameters

​
model
string
required
Model name, available options:
  • nano-banana
  • nano-banana-pro
  • nano-banana-pro-stable
  • nano-banana-2-stable
  • nano-banana-2
​
prompt
string
required
Image generation promptExample: "A cute orange cat sitting on a windowsill looking at the scenery outside"
​
resolution
string
nano-banana、nano-banana-2、nano-banana-2-stable According to the restricted ability instructions, it is recommended to use 1K
Available options:
  • 1k - 1K resolution
  • 2k - 2K resolution
  • 4k - 4K resolution
​
size
string
Aspect ratio settingAvailable options:
  • 1:1 - Square
  • 16:9 - Landscape widescreen
  • 9:16 - Portrait
  • 4:3 - Standard landscape
  • 3:4 - Standard portrait
  • 3:2 - Classic landscape
  • 2:3 - Classic portrait
  • 5:4 - Slightly wide landscape
  • 4:5 - Slightly tall portrait
  • 21:9 - Ultra-wide
​
image_urls
array
Array of reference image URLs to guide image generation style, up to 6 images

​
Response Parameters

​
id
string
Unique identifier for the image generation task, used for subsequent status queries
​
object
string
Object type, always nanobanana
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
​
error
string
Error message, returned when status is failed

​
Model Features

nano-banana-fast

Basic model, fast generation, suitable for general use

nano-banana-2

Enhanced model with resolution settings support, higher quality

nano-banana-pro

Professional model, highest quality, supports 4K resolution

​
Important Notes

Important:
  • Image generation is asynchronous, use the returned id to query task status and results
  • resolution parameter is only effective when using nano-banana-2 or nano-banana-pro models
  • Recommended polling interval is 2-5 seconds, avoid frequent requests
Best Practices:
  1. Use application/json format for requests
  2. Prompts should clearly describe the desired image content and style
  3. Reference images can help guide generation style but are not required; up to 6 images are supported
  4. Choose appropriate aspect ratio to match your use case
curl --request POST \
--url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/banana/images \
--header 'Authorization: Bearer {{key}}' \
--header 'Content-Type: application/json' \
--data '{
"model": "nano-banana-2",
"prompt": "A cute orange cat sitting on a windowsill looking at the scenery outside",
"resolution": "2k",
"size": "16:9",
"image_urls": []
}'

{
    "id": "abc123def456",
    "object": "image",
    "created": 1761635478,
    "model": "nano-banana-2",
    "status": "queued"
}