Skip to main content

​
Overview

veo3.1 is a video generation model with excellent motion consistency.
  • Type: Video Generation
  • Processing: Asynchronous
  • Duration: 1-60 seconds
  • Price: $0.08 per second

​
Parameters

​
model
string
required
veo3.1
​
prompt
string
required
Description of the video to generate (max 2000 characters)
​
negative_prompt
string
What to avoid in the video (max 1000 characters)
​
duration
integer
Video duration in seconds (1-60, default: 5)
​
aspect_ratio
string
Aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4
​
image_url
string
Reference image URL for image-to-video generation
​
mode
string
Generation mode:
  • fast - Quick generation with slightly lower quality
  • relaxed - Low priority mode (free tier, no credits consumed)
​
orientation
string
Video orientation: portrait or landscape

​
Example

curl -X POST https://api.eggapi.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "A timelapse of clouds moving over mountains",
    "duration": 10,
    "aspect_ratio": "16:9",
    "mode": "fast"
  }'

​
Response

{
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "model": "veo3.1"
  },
  "error": null
}
Video generation is asynchronous. Use the Tasks API to poll for results.