Video Generation

Stable

Generate AI-powered videos from text descriptions using Fal.ai models.

Generate Video

POST/api/v1/generate-video

Create videos from text prompts.

Request

cURL


curl -X POST "https://cloud.milady.ai/api/v1/generate-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A butterfly flying through a colorful garden",
    "model": "fal-ai/veo3"
  }'

JavaScript


const response = await fetch('https://cloud.milady.ai/api/v1/generate-video', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'A butterfly flying through a colorful garden',
    model: 'fal-ai/veo3',
  }),
});
 
const data = await response.json();
console.log(data.video.url);

Python


import requests
 
response = requests.post(
    'https://cloud.milady.ai/api/v1/generate-video',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'prompt': 'A butterfly flying through a colorful garden',
        'model': 'fal-ai/veo3',
    }
)
 
data = response.json()
print(data['video']['url'])

Parameters

Parameter	Type	Required	Description
`prompt`	string	✓	Description of the video to generate
`model`	string		Model to use. Default: `fal-ai/veo3`

Response


{
  "success": true,
  "video": {
    "url": "https://your-storage.vercel-storage.com/videos/abc123.mp4"
  },
  "model": "fal-ai/veo3"
}

Available Models

Model	Provider	Quality	Speed
`fal-ai/veo3`	Google	Highest	Slow
`fal-ai/veo3/fast`	Google	High	Fast
`fal-ai/veo3.1`	Google	Highest	Slow
`fal-ai/veo3.1/fast`	Google	High	Fast
`fal-ai/veo3.1/lite`	Google	Good	Fast
`fal-ai/kling-video/v3/pro/text-to-video`	Kling	Highest	Medium
`fal-ai/kling-video/v3/standard/text-to-video`	Kling	High	Fast
`fal-ai/kling-video/v2.6/pro/text-to-video`	Kling	High	Medium
`fal-ai/minimax/hailuo-2.3/pro/text-to-video`	MiniMax	High	Medium
`fal-ai/minimax/hailuo-2.3/standard/text-to-video`	MiniMax	Good	Fast
`wan/v2.6/text-to-video`	Wan	High	Medium
`fal-ai/pixverse/v5.6/text-to-video`	PixVerse	High	Fast
`fal-ai/pixverse/v5.5/text-to-video`	PixVerse	Good	Fast
`fal-ai/pixverse/v5/text-to-video`	PixVerse	Good	Fast

Video pricing is model-specific and refreshed from fal provider pages. Default request costs vary materially by model; inspect the API Explorer or pricing summary endpoint for current ranges.

Prompt Tips

Camera Movements

Include camera direction in prompts:

camera pan left/right
zoom in/out
dolly forward/backward
tracking shot
aerial view

Scene Description

Be specific about the scene:


{
  "prompt": "A golden retriever running through autumn leaves in a park, slow motion, cinematic lighting, tracking shot following the dog"
}

Video generation typically takes 30-180 seconds depending on model and complexity.

Error Handling

Code	Error	Solution
400	Invalid prompt	Check prompt is non-empty string
400	Invalid model	Use a supported model from the list above
402	Insufficient credits	Add credits to your account
429	Rate limited	Wait and retry with exponential backoff
500	Generation failed	Retry, or try a different model