NanoBanana Pro Image Edit

Edit existing images with high quality using the gemini-3-pro-image-preview model. Supports 1K/2K/4K resolution.

Note: The actual API endpoint is POST /v1/task/create. Providing image_urls in the input switches to image editing mode.

NanoBanana Pro Image Edit

post

Create async image editing task based on reference images. Returns task_id for subsequent queries. Note: Actual API endpoint is POST /v1/task/create, switches to image editing mode by passing image_urls parameter.

Authorizations

BearerAuth

AuthorizationstringRequired

Authenticate using Bearer Token. Get API Key at https://viralapi.ai/api-key

Body

application/json

modelstring · enumRequired

Model name, must be set to gemini-3-pro-image-preview

Possible values:

task_typestring · enumRequired

Task type, must be set to image

Possible values:

Responses

200

Task created successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

402

Insufficient account balance

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

500

Internal server error

application/json

502

Gateway error

application/json

post

/v1/task/create-image-edit

HTTPcURLJavaScriptPython

POST /v1/task/create-image-edit HTTP/1.1
Host: viralapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 227

{
  "model": "gemini-3-pro-image-preview",
  "task_type": "image",
  "input": {
    "prompt": "Transform this into a cyberpunk style with neon lights",
    "image_urls": [
      "https://example.com/input-image.jpg"
    ],
    "image_size": "2K",
    "aspect_ratio": "9:16"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "task_nano-banana-pro_1765178625768"
  }
}