3. Check Generation Status

Use the taskId to check your video's progress:

curl -H "Authorization: Bearer veo_your_api_key_here" \
  https://api.veo3gen.app/api/status/veo_1704067200000_abc123

The API supports three authentication methods:

Authorization: Bearer veo_your_api_key_here

X-API-Key: veo_your_api_key_here

?api_key=veo_your_api_key_here

GET /api/logs

Retrieve your generation history with filtering and pagination

Error Response Format

{
  "success": false,
  "error": "User-friendly error message",
  "errorType": "ERROR_TYPE_CONSTANT",
  "details": {
    "field": "specific field that caused the error"
  }
}

Retry Strategy Example:

async function retryableRequest(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      const isRetryable = [
        'RATE_LIMIT_EXCEEDED',
        'QUOTA_EXCEEDED', 
        'SYSTEM_ERROR'
      ].includes(error.errorType);
      
      if (!isRetryable || i === maxRetries - 1) {
        throw error;
      }
      
      // Exponential backoff
      const delay = Math.min(1000 * Math.pow(2, i), 30000);
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}

const axios = require('axios');

class VEO3Client {
  constructor(apiKey, baseURL = 'https://api.veo3gen.app') {
    this.apiKey = apiKey;
    this.baseURL = baseURL;
    this.client = axios.create({
      baseURL,
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      }
    });
  }

  async generateVideo(prompt, options = {}) {
    try {
      console.log('Starting video generation...');
      console.log(`Prompt: ${prompt}`);
      console.log(`Model: ${options.model || 'veo3-fast'}`);
      
      const response = await this.client.post('/api/generate', {
        model: options.model || 'veo3-fast',
        prompt,
        audio: options.audio !== false,
        options: {
          resolution: options.resolution || '720p',
          aspectRatio: options.aspectRatio || '16:9',
          ...options.veo3Options
        }
      });

      console.log(`Generation started with task ID: ${response.data.taskId}`);
      return response.data;
    } catch (error) {
      console.error('Generation request failed:', error.message);
      throw new Error(`Generation failed: ${error.response?.data?.error || error.message}`);
    }
  }

  async pollStatus(taskId, maxWaitTime = 300000) {
    const startTime = Date.now();
    console.log(`Starting to poll status for task: ${taskId}`);
    
    while (Date.now() - startTime < maxWaitTime) {
      try {
        const response = await this.client.get(`/api/status/${taskId}`);
        const status = response.data;

        console.log(`Status check: ${status.status}`);

        if (status.status === 'completed') {
          console.log('Video generation completed successfully!');
          return status;
        } else if (status.status === 'failed') {
          console.log('Video generation failed');
          throw new Error(status.error.message);
        }

        console.log('Video still processing, waiting 10 seconds...');
        // Wait 10 seconds before next poll
        await new Promise(resolve => setTimeout(resolve, 10000));
      } catch (error) {
        console.error('Error during status check:', error.message);
        throw new Error(`Status check failed: ${error.response?.data?.error || error.message}`);
      }
    }

    console.log('Video generation timed out');
    throw new Error('Video generation timed out');
  }

  async generateAndWait(prompt, options = {}) {
    const generation = await this.generateVideo(prompt, options);
    const result = await this.pollStatus(generation.taskId, options.maxWaitTime);
    return result;
  }
}

// Usage
const client = new VEO3Client('veo_your_api_key_here');

async function example() {
  try {
    const result = await client.generateAndWait(
      'A majestic eagle soaring over mountains',
      {
        model: 'veo3-quality',
        audio: true,
        resolution: '1080p'
      }
    );

    console.log('Video generated!', result.result.videoUrl);
  } catch (error) {
    console.error('Error:', error.message);
  }
}

example();