Lily AI Veo3 API Documentation

Welcome to the official documentation for the Lily AI Veo3 Image-to-Video (I2V) API. This guide will help you understand how to integrate and use our powerful AI-driven video generation service.

1. Introduction

The Lily AI Veo3 API allows you to transform static image prompts into dynamic video sequences. By providing a descriptive image prompt and an optional video prompt, our AI generates high-quality video content.

2. Authentication

All requests to the Lily AI Veo3 API must be authenticated using a unique API token. You can generate and manage your API tokens from your user dashboard under the "API Tokens" section.

How to obtain your API Token:

1. Register for an account (if you haven't already).
2. Log in to your dashboard.
3. Navigate to the API Tokens page.
4. Generate a new token. Make sure to copy the full token value immediately, as it will only be shown once for security reasons.

Providing the Token:

Your API token must be included in the Authorization header of every request.

CopyAuthorization: YOUR_API_TOKEN_HERE

3. API Endpoint

The primary endpoint for interacting with the Lily AI Veo3 API is:

CopyPOST https://google-api.lailaautobot.one/api.php

4. Request Format

Requests must be sent as POST requests with a Content-Type: application/json header. The request body should be a JSON object containing the following parameters:

Request Headers:

Request Body Parameters:

Example Request (using curl)

Copycurl -X POST "https://google-api.lailaautobot.one/api.php" \
     -H "Content-Type: application/json" \
     -H "Authorization: YOUR_API_TOKEN_HERE" \
     -d '{
           "prompt_image": "A majestic eagle soaring over mountains",
           "prompt_video": "The eagle dives gracefully towards a river, catching a fish"
         }' \
     --max-time 600

Windows CMD Example:

Copycurl -X POST "https://google-api.lailaautobot.one/api.php" ^
     -H "Content-Type: application/json" ^
     -H "Authorization: YOUR_API_TOKEN_HERE" ^
     -d "{\"prompt_image\": \"A majestic eagle soaring over mountains\", \"prompt_video\": \"The eagle dives gracefully towards a river, catching a fish\"}" ^
     --max-time 600

Windows PowerShell Example:

Copycurl -Method POST "https://google-api.lailaautobot.one/api.php" `
     -Headers @{"Content-Type" = "application/json"; "Authorization" = "YOUR_API_TOKEN_HERE"} `
     -Body '{"prompt_image": "A majestic eagle soaring over mountains", "prompt_video": "The eagle dives gracefully towards a river, catching a fish"}' `
     -TimeoutSec 600

5. Response Format

All successful responses will be returned as a JSON object.

Success Response (HTTP Status: 200 OK)

Example Success Response

Copy{
  "status": "SUCCESS_I2V",
  "video_url": "https://google-api.lailaautobot.one/Video/lily-i2v-veo30-27224.mp4"
}

6. Error Handling

In case of an error, the API will return a JSON object with an error status and a descriptive message. The HTTP status code will indicate the type of error.

Error Response Format:

Common Error Codes:

Example Error Response

Copy{
  "status": "ERROR",
  "message": "Authorization token missing."
}

7. Rate Limits

Information on rate limits will be provided here. Currently, no explicit rate limits are enforced, but excessive requests may lead to temporary blocking or throttling to ensure service stability. Please use the API responsibly.

8. Support

If you encounter any issues or have questions that are not covered in this documentation, please reach out to our support team at support@lailaautobot.one. Please include your User ID, the API token you are using, and detailed steps to reproduce any issues.