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>"
}Google
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.
POST
/
api
/
generate
/
submit
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>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- google/nano-banana-2-lite/edit - Edit images using a prompt and image references.
Features
- Edit images using a prompt and image references.
- Accepts 1-14 images in
image_urls.
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.autois not accepted.
Advanced Parameters
Setmodel 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.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.