Veo 3 Video Generation

Generate high-quality videos from text prompts using Google's Veo 3 model via Fal.ai. Veo 3 produces cinema-quality videos with native audio generation.

POST

/api/v1/models/veo3

Generate video from a text prompt

Processing

Async (Job-based)

Cost

25-50 credits/video

Duration

5 or 10 seconds

This is an async endpoint. It returns a job ID immediately. Poll /api/v1/jobs/{jobId} to check status and get the result.

Request Body

Name	Type	Description
`prompt`required	`string`	Text description of the video to generate (max 2000 chars)
`image_url`	`string`	Optional image URL to use as first frame (image-to-video mode)
`duration`	`string`Default: `10`	Video duration: '5' or '10' seconds
`aspect_ratio`	`string`Default: `16:9`	Aspect ratio: '16:9', '9:16', or '1:1'
`enhance_prompt`	`boolean`Default: `true`	Let the model enhance your prompt for better results
`seed`	`number`	Random seed for reproducible results

Pricing

5 Second Video

25 credits

~$0.25 equivalent

10 Second Video

50 credits

~$0.50 equivalent

Example Request

curl -X POST https://vydra.ai/api/v1/models/veo3 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene Japanese garden with cherry blossoms falling gently into a koi pond, golden hour lighting, cinematic quality",
    "duration": "10",
    "aspect_ratio": "16:9"
  }'

Image-to-Video Mode

Provide an image URL to use as the first frame of your video:

{
  "prompt": "The woman smiles and waves at the camera, warm natural lighting",
  "image_url": "https://example.com/portrait.jpg",
  "duration": "5",
  "aspect_ratio": "9:16"
}

Initial Response (202 Accepted)

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Video generation job created. Poll /api/v1/jobs/{jobId} for status.",
  "creditsCharged": 50,
  "externalJobId": "fal-abc123",
  "input": {
    "prompt": "A serene Japanese garden with cherry blossoms...",
    "duration": "10",
    "aspect_ratio": "16:9"
  }
}

Completed Job Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "output": {
    "videoUrl": "https://cdn.vydra.ai/videos/veo3/org_123/output.mp4",
    "durationSeconds": 10,
    "aspectRatio": "16:9"
  },
  "createdAt": "2024-01-26T12:00:00.000Z",
  "completedAt": "2024-01-26T12:03:30.000Z"
}

Prompt Tips

✅ Be Descriptive

Include details about lighting, camera movement, style, and mood. Example: "Cinematic drone shot of waves crashing on a rocky coast, golden hour, slow motion"

✅ Specify Camera Motion

Use terms like "tracking shot", "pan left", "zoom in", "static shot", "handheld"

✅ Include Style Keywords

Add style modifiers: "4K", "cinematic", "documentary style", "anime", "photorealistic"

⚠️ Keep It Simple

Focus on one main action or scene. Complex multi-part descriptions may produce unexpected results.

Use Cases

🎬 Marketing Videos

Generate b-roll footage for ads and promotional content.

📱 Social Media

Create eye-catching short-form content for TikTok, Reels, Shorts.

🎨 Concept Visualization

Bring creative concepts to life for pitches and presentations.

📖 Storytelling

Generate visual narratives for stories and educational content.