curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "google/nano-banana-2-lite/edit",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail."
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Nano Banana 2 Lite Edit

Combine text instructions with up to fourteen reference images in Nano Banana 2 Lite to explore new scenes and visual variations.

​

Available Models

• google/nano-banana-2-lite/edit - Edit images using a prompt and image references.

​

Output Options

​

Aspect Ratio

• size: Optional. Accepted values: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. If omitted, no explicit aspect ratio is specified; there is no default. auto is not accepted.

​

Key Features

• Edit images using a prompt and image references.
• Accepts 1-14 images in image_urls.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

​

Prompt

• prompt: Required. Describe the requested changes. Minimum length: 1 character.
• The value must not be blank when supplied. No maximum prompt length is specified.

​

Image URLs

• image_urls: Required. Provide publicly accessible image URLs. Supply 1-14 items. Each item must be an HTTP(S) URL.

​

Billing Factors

Billed per generation. Text-to-image and image editing use the same billing rate. The selected aspect ratio (size) and reference image count do not add charges. Credits are deducted on submission and refunded if the task fails.