跳到导航
BeatAPINano Banana 2 1Image API

Nano Banana 2.1

Generate or edit images with the successor to Nano Banana 2, from text and up to 14 public HTTPS reference images, with 1K, 2K, or 4K output.

Supported modes

ModeRequired inputRules
Text to imagemodel, promptOmit images.
Reference imagemodel, prompt, imagesProvide 1–14 public HTTPS PNG, JPEG or WebP image URLs.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

身份验证

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

请求头

Idempotency-Keystring可选<=255 characters

请求

This endpoint expects an object.
model"nano-banana-2.1"必需

Must be nano-banana-2.1.

promptstring必需1-5000 characters

Generation or image-editing instructions.

imageslist of strings可选

Public HTTPS reference-image URLs in PNG, JPEG or WebP; each link is checked when the task is created, and one that is not such an image (an error page, a GIF, a 404) is refused with 400. Omit for text-to-image.

aspect_ratioenum可选默认为 1:1
Output image aspect ratio.
resolutionenum可选默认为 1K
Output resolution tier.
允许的值:
output_formatenum可选默认为 png
Output image file format.
允许的值:

响应

Image generation task accepted

错误

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error