Generate Video

Generate videos using AI with automatic provider fallback. Supports Gemini Veo 3.1 for video generation. Videos are automatically saved to storage and can be used in conversations or content.

Input Schema

Parameter	Type	Description
prompt	string	Detailed text description of the video to generate. Be specific about style, colors, composition, movement, and any important details.
provider	string	AI provider to use for generation. Only Gemini is currently supported.
duration_seconds	number	Desired duration of the video in seconds. Will be mapped to valid values (4, 6, or 8 seconds) by the API. Defaults to 8 seconds.
aspect_ratio	string	Aspect ratio of the generated video. Note: Gemini only supports 16:9 and 9:16, other ratios will be mapped to 16:9. Defaults to 16:9. Enum: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
reference_images	array	Array of image URLs (up to 3) to use as reference/context for generation. Images will be converted to base64 and sent as context to the AI model. When using reference images, duration must be 8 seconds.
quality	string	Quality of the generated video. “preview” and “standard” use 720p. “pro” uses 1080p but requires duration=8 and aspect_ratio=16:9. Defaults to standard. Enum: preview, standard, pro
model	string	Override the Gemini model to use (default: veo-3.1-generate-preview).

REST Endpoint


POST /api/ai/video

The site_id field is required when calling via REST.


POST /api/ai/video
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "prompt": "A timelapse of a city skyline at sunset, cinematic, 4K",
  "duration_seconds": 8,
  "aspect_ratio": "16:9",
  "quality": "standard"
}

Response:


{
  "success": true,
  "videos": [
    { "url": "https://...", "mimeType": "video/mp4" }
  ],
  "metadata": {
    "model": "veo-3.1-generate-preview",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }
}