Nano Banana 2 1

Generate images from text or edit images using up to 14 references. Supports 1K, 2K, and 4K output in JPG or PNG format.

Model

Pricing

Per-image billing by output resolution:

Your account pricing multiplier applies when configured. Credits are rounded to two decimal places. Reference images do not add a separate charge.

Create Task

curl -X POST https://api.aivideoapi.ai/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-1",
    "callback_url": "https://your-server.com/webhook",
    "input": {
      "prompt": "A cute cat wearing sunglasses sitting on a beach, digital art style",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "jpg"
    }
  }'

Request Body

Input Object

Playground file uploads have a 10 MB limit per image. The API accepts public image URLs with the 30 MB limit above.

Example: Image Editing

{
  "model": "nano-banana-2-1",
  "input": {
    "prompt": "Replace the jacket with a yellow raincoat. Preserve the person's identity, pose, framing, and lighting.",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "2K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}

Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "397ce9f2-c04e-4244-ac33-3af19a7cc297"
  }
}

Query Task

curl https://api.aivideoapi.ai/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk-your-api-key"

Status transitions: pending → processing → completed or failed. Poll until the task reaches a final status, or use callback_url to receive the result.

Completed

{
  "id": "397ce9f2-c04e-4244-ac33-3af19a7cc297",
  "status": "completed",
  "model": "nano-banana-2-1",
  "created_at": 1791421200,
  "completed_at": 1791421220,
  "output": {
    "urls": ["https://file.aivideoapi.ai/images/example.png"]
  }
}

Read the generated images from output.urls.

Failed

{
  "id": "57c8772c-f834-46f3-9b7d-81f92e104050",
  "status": "failed",
  "model": "nano-banana-2-1",
  "created_at": 1791421200,
  "error": {
    "code": "upstream_error",
    "message": "Image generation failed"
  }
}

Pre-charged credits are refunded when a task fails. Completed tasks retain their charge. Duplicate notifications do not create additional charges or refunds.

Callback

Pass callback_url when creating the task to receive a POST notification after completion or failure. The notification uses the same response format as the task query.

Error Codes

When a request fails, the API returns a JSON error response:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

Error Reference

Common Scenarios

invalid_request (400)

Returned when required fields are missing or invalid.

{
  "error": {
    "code": "invalid_request",
    "message": "'model' is required.",
    "type": "invalid_request_error"
  }
}

insufficient_credits (402)

Your balance is too low. Check your balance with GET /v1/credits and top up in Dashboard > Billing.

invalid_api_key (401)

Possible causes:

• The key does not start with sk-
• The key has been disabled or deleted
• The user account has been banned

upstream_error (503)

The upstream AI provider returned an error. This may happen when:

• The input contains sensitive or prohibited content
• The provider is temporarily unavailable
• The request parameters are not supported by the provider

Credits are automatically refunded when a task fails due to upstream errors.