NanoBanana Text to Image

Generate images from text prompts using the gemini-2.5-flash-image model.

NanoBanana Text to Image

post

Create async image generation task. Returns task_id for subsequent queries.

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

HTTPcURLJavaScriptPython

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

{
  "model": "gemini-2.5-flash-image",
  "task_type": "image",
  "input": {
    "prompt": "A serene mountain landscape at sunset with vibrant colors",
    "aspect_ratio": "16:9"
  }
}

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