NanoBanana Image Edit

Edit existing images based on text instructions using the gemini-2.5-flash-image model.

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

NanoBanana 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-2.5-flash-image

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 — Token missing or invalid

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: 197

{
  "model": "gemini-2.5-flash-image",
  "task_type": "image",
  "input": {
    "prompt": "Transform this into a watercolor painting style",
    "image_urls": [
      "https://example.com/input-image.jpg"
    ],
    "aspect_ratio": "1:1"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "task_nanobanana_1765178625768"
  }
}