API Documentation

The Nano Banana Video API allows you to generate videos from text prompts or images programmatically. The API uses API key authentication and provides endpoints for text-to-video and image-to-video generation.

All API requests require authentication using an API key. You can obtain your API key from your dashboard after logging in.

API Key Usage

You can provide your API key in one of the following ways:

X-API-Key: your_api_key_here

Authorization: Bearer your_api_key_here

?api_key=your_api_key_here

Generate a video from a text prompt.

Parameters

Request Example

{
  "prompt": "A beautiful sunset over the ocean",
  "resolution": "1080p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Response Example

{
  "success": true,
  "video_id": 123,
  "video_url": "https://example.com/video.mp4",
  "thumbnail_url": "https://example.com/thumbnail.jpg",
  "credits_used": 5,
  "rate_limit": {
    "count": 1,
    "limit": 10,
    "remaining": 9
  }
}

cURL Example

curl -X POST https://nanobananavideo.com/api/v1/text-to-video.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "prompt": "A beautiful sunset over the ocean",
    "resolution": "1080p",
    "duration": 5
  }'

Generate a video from one or more image URLs.

Request Example

{
  "image_urls": ["https://example.com/image.jpg"],
  "prompt": "Animate this image with gentle motion",
  "resolution": "1080p",
  "duration": 5
}

Python Example

import requests

url = "https://nanobananavideo.com/api/v1/image-to-video.php"
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "your_api_key_here"
}
data = {
    "image_urls": ["https://example.com/image.jpg"],
    "prompt": "Animate this image",
    "resolution": "1080p",
    "duration": 5
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print(result)

Get the status and details of a video generation.

Status Values

All error responses follow this format:

{
  "success": false,
  "error": "Error message describing what went wrong"
}

HTTP Status Codes

Video generation consumes credits from your account.