Image to Video

Total Cost = Base Cost + (Additional Seconds × Per-Second Rate)

curl -X GET https://api.percify.io/v1/videos/video_456 \
  -H "Authorization: Bearer $PERCIFY_API_KEY"

{
  "id": "video_456",
  "status": "completed",
  "videoUrl": "https://cdn.percify.io/videos/video_456.mp4",
  "thumbnailUrl": "https://cdn.percify.io/videos/video_456_thumb.jpg",
  "durationSeconds": 5,
  "resolution": "720p",
  "fps": 30,
  "fileSize": 2456789,
  "creditCost": 30,
  "createdAt": "2025-11-25T05:40:00Z",
  "completedAt": "2025-11-25T05:40:45Z"
}

async function waitForVideo(videoId) {
  const maxAttempts = 60; // 5 minutes max
  const pollInterval = 5000; // 5 seconds
  
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(
      `https://api.percify.io/v1/videos/${videoId}`,
      {
        headers: { 'Authorization': `Bearer ${process.env.PERCIFY_API_KEY}` }
      }
    );
    
    const video = await response.json();
    
    if (video.status === 'completed') {
      return video;
    } else if (video.status === 'failed') {
      throw new Error(`Video generation failed: ${video.error}`);
    }
    
    await new Promise(resolve => setTimeout(resolve, pollInterval));
  }
  
  throw new Error('Video generation timed out');
}

// 1. Generate video
const video = await client.videos.fromImage({
  imageId: 'avatar_123',
  durationSeconds: 8
});

// 2. Generate voice audio
const audio = await client.audio.generate({
  text: 'Welcome to Percify! Create amazing AI avatars in seconds.',
  voiceId: 'voice_default',
  speed: 1.0
});

// 3. Sync audio with video (automatic lip-sync)
const syncedVideo = await client.videos.addAudio({
  videoId: video.id,
  audioId: audio.id,
  enableLipSync: true
});

console.log(`Final video URL: ${syncedVideo.videoUrl}`);

await client.videos.fromImage({
  imageId: 'avatar_123',
  durationSeconds: 5,
  background: {
    type: 'replacement',
    imageUrl: 'https://example.com/custom-bg.jpg'
  }
});

await client.videos.fromImage({
  imageId: 'avatar_123',
  durationSeconds: 10,
  cameraMotion: {
    type: 'zoom-in',
    intensity: 'subtle'
  }
});

await client.videos.fromImage({
  imageId: 'avatar_123',
  durationSeconds: 5,
  fps: 60, // 24, 30, or 60
  studioTier: 'reality-lab' // 60fps requires Reality Lab
});

// Setup webhook endpoint
app.post('/webhooks/percify', (req, res) => {
  const event = req.body;
  
  if (event.type === 'video.completed') {
    const video = event.data;
    console.log(`Video ${video.id} completed: ${video.videoUrl}`);
    
    // Process completed video
    processVideo(video);
  }
  
  res.sendStatus(200);
});