Documentation

Complete guide to using Veo 3 AI Video Prompt Generator

Learn how to create professional video prompts, understand parameter controls, and integrate with the Veo 3 API for seamless video generation.

Quick Start Guide

Get started with Veo 3 AI Video Prompt Generator in just a few simple steps. This guide will walk you through the basic workflow from prompt creation to video generation.

Step 1: Access the Generator

Navigate to the main generator interface at index.html. You'll see a comprehensive form with all available parameters organized into collapsible sections.

Step 2: Configure Your Video

Expand each parameter section and configure your video settings:

  • Video Concept: Choose visual style, mood, and theme
  • Technical Settings: Set resolution, frame rate, and CFG scale
  • Visual Style: Select color palettes and lighting
  • Camera Controls: Define camera movements and stabilization
  • Character Details: Specify character appearance and actions
  • Audio Settings: Configure language, voice, and audio type

Step 3: Generate Output

As you configure parameters, the tool automatically generates both JSON and text formats in real-time. You can see the live preview in the output panel on the right side.

Step 4: Copy and Use

Click the "Copy JSON" or "Copy Text" buttons to copy the generated prompt to your clipboard. Paste it directly into Veo 3's interface or API calls for video generation.

💡 Pro Tip

Start with one of the quick templates (Cinematic, Commercial, Documentary, or Anime) and then customize the parameters to match your specific needs.

Parameter Reference

Video Concept & Style

Parameter Type Options Description
visualStyle Select cinematic, realistic, artistic, documentary, commercial, anime, stop-motion Overall visual aesthetic and production style
mood Select energetic, serene, mysterious, dramatic, playful, romantic, tense Emotional atmosphere and tone
theme Text Free text Narrative theme and story description

CFG Scale (Classifier-Free Guidance)

Parameter Type Range Description
cfgScale Slider 3-16 Controls balance between creativity and prompt adherence

CFG Scale Guidelines

Low (3-5)

More creative and diverse outputs, less strict adherence to prompt

Medium (7-9)

Optimal balance between creativity and prompt accuracy (Recommended)

High (12-16)

Very strict adherence to prompt, less creative variation

Resolution & Format

Parameter Type Options Description
aspectRatio Select 16:9, 9:16, 1:1, 21:9, 4:3 Video aspect ratio and dimensions
resolutionQuality Select 4K, 1440p, 1080p Video resolution and quality
frameRate Select 24fps, 30fps, 60fps Frames per second for smoothness

Best Practices

🎯 Optimal CFG Scale

For most use cases, set CFG scale between 7-9. This provides the best balance between creative interpretation and prompt adherence.

  • • Creative projects: Use 5-7 for more artistic freedom
  • • Commercial work: Use 8-10 for precise control
  • • Technical demos: Use 10-12 for strict accuracy

📝 Effective Prompt Writing

Write clear, descriptive prompts that provide specific details about the desired outcome without being overly restrictive.

  • • Include specific visual details (colors, lighting, composition)
  • • Describe the mood and emotional tone
  • • Specify character actions and expressions
  • • Mention environmental context and setting
  • • Keep dialog under 100 characters for optimal lip-sync

🎬 Cinematic Techniques

Apply professional cinematography principles to enhance your video quality and visual storytelling impact.

  • • Use rule of thirds in composition
  • • Apply appropriate camera movements for the scene
  • • Consider lighting direction and quality
  • • Match color grading to the mood and genre
  • • Use depth of field to focus attention

⚡ Performance Optimization

Optimize your prompts for faster generation and better results while maintaining quality and creative control.

  • • Use 1080p for initial testing, then upscale to 4K
  • • Keep videos under 10 seconds for rapid iteration
  • • Use appropriate frame rates (24fps for cinematic, 30fps for standard)
  • • Batch similar requests for efficiency
  • • Cache successful prompt combinations

JSON Schema

The complete JSON schema for Veo 3 API integration. This structured format ensures compatibility and optimal performance with the video generation service.

{
  "videoConcept": {
    "visualStyle": "cinematic",
    "mood": "dramatic",
    "theme": "A compelling narrative with emotional depth"
  },
  "cfgScale": 8,
  "resolution": {
    "aspectRatio": "16:9",
    "quality": "4K",
    "frameRate": "24fps"
  },
  "visualStyle": {
    "colorPalette": ["warm", "vibrant"],
    "colorGrading": "golden-hour",
    "lighting": "golden-hour"
  },
  "tempo": {
    "duration": "15s",
    "speed": "normal",
    "pacing": "moderate"
  },
  "cameraMovements": {
    "panTilt": ["pan-left", "tilt-up"],
    "dolly": ["dolly-in"],
    "tracking": ["tracking-shot"],
    "stabilization": ["steadicam"]
  },
  "character": {
    "physicalDescription": "30-year-old professional, confident posture",
    "expression": "confident",
    "gestures": "Hand gestures while speaking",
    "actions": "walking"
  },
  "language": {
    "language": "english",
    "dialog": "Welcome to the future of video creation"
  },
  "audio": {
    "voiceTone": "professional",
    "speakingPace": "moderate",
    "accent": "american",
    "audioType": "mixed"
  },
  "wardrobe": {
    "clothingStyle": "business",
    "location": "studio",
    "timeOfDay": "morning",
    "weather": "sunny"
  }
}

Required Fields

  • • videoConcept.visualStyle
  • • videoConcept.mood
  • • cfgScale
  • • resolution.aspectRatio
  • • resolution.quality
  • • resolution.frameRate

Optional Fields

  • • videoConcept.theme
  • • character.physicalDescription
  • • language.dialog
  • • visualStyle.colorPalette
  • • cameraMovements.*
  • • All wardrobe parameters

API Integration

Integrate Veo 3 video generation into your applications using the generated JSON prompts. The API supports both synchronous and asynchronous generation modes.

Basic API Call

const generateVideo = async (promptData) => {
  try {
    const response = await fetch('https://api.veo3.google.com/v1/generate', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        prompt: promptData,
        settings: {
          quality: 'high',
          timeout: 300000 // 5 minutes
        }
      })
    });
    
    const result = await response.json();
    return result.videoUrl;
  } catch (error) {
    console.error('Generation failed:', error);
    throw error;
  }
};

Async Generation with Webhooks

const submitAsyncGeneration = async (promptData, webhookUrl) => {
  const response = await fetch('https://api.veo3.google.com/v1/generate/async', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      prompt: promptData,
      webhook: webhookUrl,
      jobId: `job_${Date.now()}`
    })
  });
  
  return await response.json(); // Returns job ID for tracking
};

Error Handling

const handleGenerationErrors = (error) => {
  switch (error.code) {
    case 'RATE_LIMIT_EXCEEDED':
      return 'Too many requests. Please wait before retrying.';
    case 'INVALID_PROMPT':
      return 'Prompt validation failed. Check parameter values.';
    case 'GENERATION_FAILED':
      return 'Video generation failed. Try adjusting parameters.';
    case 'TIMEOUT':
      return 'Generation timed out. Try a simpler prompt or shorter duration.';
    default:
      return 'An unknown error occurred. Please try again.';
  }
};

Troubleshooting

❌ Generation Quality Issues

Problem: Video looks blurry or low quality

Solution: Increase resolution to 4K and ensure CFG scale is 7-9

Problem: Character movements are unnatural

Solution: Use specific action descriptions and consider motion blur settings

Problem: Colors are oversaturated

Solution: Adjust color palette to "muted" or use natural color grading

⚠️ Performance Issues

Problem: Generation is very slow

Solution: Reduce resolution to 1080p, shorten duration, or simplify the scene

Problem: API timeouts

Solution: Use async generation mode or reduce prompt complexity

Problem: Rate limiting

Solution: Implement exponential backoff and batch processing

🔧 Technical Issues

Problem: JSON validation errors

Solution: Ensure all required fields are present and values are correct types

Problem: Character limit exceeded

Solution: Keep dialog under 100 characters and theme descriptions concise

Problem: Incompatible parameter combinations

Solution: Check parameter compatibility matrix in documentation

Examples

Ready-to-use examples showcasing different video styles and use cases. Copy these examples and modify them for your specific needs.

Cinematic Short Film

{
  "videoConcept": {
    "visualStyle": "cinematic",
    "mood": "dramatic",
    "theme": "A lone traveler discovers an ancient artifact in a mysterious temple"
  },
  "cfgScale": 8,
  "resolution": {
    "aspectRatio": "21:9",
    "quality": "4K",
    "frameRate": "24fps"
  },
  "visualStyle": {
    "colorPalette": ["warm", "muted"],
    "colorGrading": "golden-hour",
    "lighting": "dramatic"
  },
  "tempo": {
    "duration": "15s",
    "speed": "normal",
    "pacing": "slow-deliberate"
  },
  "cameraMovements": {
    "panTilt": ["pan-right", "tilt-up"],
    "tracking": ["tracking-shot"],
    "stabilization": ["steadicam"]
  }
}

Product Commercial

{
  "videoConcept": {
    "visualStyle": "commercial",
    "mood": "energetic",
    "theme": "Premium smartphone showcasing cutting-edge camera technology"
  },
  "cfgScale": 9,
  "resolution": {
    "aspectRatio": "16:9",
    "quality": "4K",
    "frameRate": "30fps"
  },
  "visualStyle": {
    "colorPalette": ["vibrant", "cool"],
    "colorGrading": "teal-orange",
    "lighting": "studio"
  },
  "tempo": {
    "duration": "10s",
    "speed": "normal",
    "pacing": "energetic"
  },
  "character": {
    "expression": "confident",
    "actions": "gesturing",
    "physicalDescription": "Young professional, modern business attire"
  },
  "language": {
    "language": "english",
    "dialog": "Capture every moment in stunning detail"
  }
}

Educational Content

{
  "videoConcept": {
    "visualStyle": "documentary",
    "mood": "serene",
    "theme": "Introduction to climate change and environmental conservation"
  },
  "cfgScale": 7,
  "resolution": {
    "aspectRatio": "16:9",
    "quality": "1080p",
    "frameRate": "24fps"
  },
  "visualStyle": {
    "colorPalette": ["natural", "muted"],
    "colorGrading": "natural",
    "lighting": "natural"
  },
  "tempo": {
    "duration": "20s",
    "speed": "normal",
    "pacing": "moderate"
  },
  "character": {
    "expression": "thoughtful",
    "actions": "speaking",
    "physicalDescription": "Scientist, lab coat, professional appearance"
  },
  "language": {
    "language": "english",
    "dialog": "Our planet's future depends on the choices we make today"
  }
}