Skip to main content
POST
Submit Nano Banana 2.1 Image Edit Task
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Optional parameters

  • size (string): Output aspect ratio. auto follows the reference image. Accepted values: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Default: auto.
  • resolution (string): Output resolution tier. Accepted values: 1K, 2K, 4K. Default: 1K.

Usage Guide

Edit one image with Nano Banana 2.1 using text instructions and reference images.
  • Set model to google/nano-banana-2.1/edit.
  • Place model and optional callback_url at the request root; place workflow parameters inside input.
  • Each request produces one image.
  • For prompt-only generation, use Text to Image with model=google/nano-banana-2.1/text-to-image.

Parameter Details

  • prompt is required. Supply non-blank text of up to 20,000 characters.
  • image_urls is required and accepts 1 to 10 reference image URLs. Use publicly accessible HTTP(S) URLs in the same order as the references in your prompt.
  • size defaults to auto. auto follows the reference image aspect ratio.

Billing

Billing is per output image and depends on resolution. Text-to-image and editing use the same rate at each tier. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json
model
string
required
Example:

"google/nano-banana-2.1/edit"

input
object
required
callback_url
string<uri>

Optional webhook URL for completion or failure notifications.

Example:

"https://your-domain.com/callback"

Response

Task submission result. A task ID identifies asynchronous work; generation may still be running.

code
integer
required
Example:

200

data
object
required