curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "nano-banana-2",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A cyberpunk street scene with neon signs and rain",
    "size": "16:9",
    "resolution": "2K"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 401,
  "error": {
    "message": "Unauthorized - Invalid API key",
    "type": "authentication_error"
  }
}

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": "nano-banana-2",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A cyberpunk street scene with neon signs and rain",
    "size": "16:9",
    "resolution": "2K"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 401,
  "error": {
    "message": "Unauthorized - Invalid API key",
    "type": "authentication_error"
  }
}

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.
Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Task Status endpoint.

Nano Banana Pro(Nano Banana 2) Image Generation

Next-generation AI image generation powered by Google’s Gemini 3 Pro Image Preview. Delivers 2K native resolution images in under 1 second with enhanced text rendering, character consistency, and designer-grade quality.

Available Models

nano-banana-2 - Text-to-image and image-to-image generation
nano-banana-2-edit - Advanced image editing capabilities

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Nano Banana 2 model identifier

Available options:

nano-banana-2,

nano-banana-2-edit

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

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

input

object

Input parameters for generation

Show child attributes

Response

Task submitted successfully

code

integer

required

HTTP status code

Example:

200

data

object

required

Show child attributes

Nano Banana Image Generation Nano Banana 2 (gemini-3.1-flash-image-preview) Image Generation

Overview

Image Series

Video Series

Music Series

File Management

Task Management

Account Management

Nano Banana Pro(Nano Banana 2) Image Generation

Nano Banana Pro(Nano Banana 2) Image Generation

Available Models

Authorizations

Body

Response

​Nano Banana Pro(Nano Banana 2) Image Generation

​Available Models

Authorizations

Body

Response

Nano Banana Pro(Nano Banana 2) Image Generation

Available Models