{
  "body": {
    "jobId": "thumb_job_123456789abcdef",
    "url": "https://worker.hesedvid.com/pubvid_AbCdEf/thumbnails/custom/12000_320x180.webp",
    "status": "pending"
  }
}

{
  "body": {
    "url": "https://worker.hesedvid.com/pubvid_AbCdEf/thumbnails/custom/5000_640x360.webp",
    "available": true,
    "width": 640,
    "height": 360
  }
}

{
  "body": {
    "status": "completed",
    "url": "https://worker.hesedvid.com/pubvid_AbCdEf/thumbnails/custom/12000_320x180.webp"
  }
}

const generateThumbnailWithRetry = async (videoId, options, maxRetries = 3) => {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await generateThumbnail(videoId, options);

      // Poll for completion
      let status = 'pending';
      while (status === 'pending' || status === 'processing') {
        await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
        const statusResponse = await checkThumbnailStatus(response.jobId);
        status = statusResponse.status;

        if (status === 'completed') {
          return statusResponse.url;
        } else if (status === 'failed') {
          throw new Error('Thumbnail generation failed');
        }
      }
    } catch (error) {
      if (attempt === maxRetries) throw error;
      await new Promise(resolve => setTimeout(resolve, 1000 * attempt)); // Exponential backoff
    }
  }
};

// Generate thumbnails for video gallery
const generateGalleryThumbnails = async (videos) => {
  const thumbnails = await Promise.all(
    videos.map(async (video) => {
      const response = await generateThumbnail(video.publicId, {
        width: 320,
        height: 180,
        timestampMs: 5000 // 5 seconds into video
      });
      return {
        videoId: video.publicId,
        thumbnailUrl: response.url,
        jobId: response.jobId
      };
    })
  );
  return thumbnails;
};

// Generate social media optimized thumbnails
const generateSocialThumbnail = async (videoId) => {
  const response = await generateThumbnail(videoId, {
    width: 1200,
    height: 630, // Facebook optimal size
    timestampMs: 0 // Use opening frame
  });
  return response.url;
};

// Generate mobile-optimized thumbnails
const generateMobileThumbnail = async (videoId) => {
  const response = await generateThumbnail(videoId, {
    width: 640,
    height: 360,
    timestampMs: 10000 // 10 seconds into video
  });
  return response.url;
};

{
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid thumbnail dimensions",
  "errors": [
    {
      "message": "Width must be between 1 and 4096 pixels",
      "location": "body.width",
      "value": 5000
    }
  ]
}