| name | extracting-thumbnails |
| description | Extracts thumbnails from video URLs. Use when publishing video content that requires a cover image, when the user does not provide a cover/thumbnail, or before publishing to platforms that require cover images (Kwai, Bilibili, YouTube). 提取封面、视频封面、生成封面、缩略图提取、视频缩略图、截取封面。 |
Thumbnail Extraction
Extracts thumbnails from video URLs for use as cover images.
When to Use
Use this skill when:
- Publishing video content that requires a cover image
- User doesn't provide a cover/thumbnail for video content
- Before publishing to platforms that require cover images (Kwai, Bilibili)
Platform Cover Requirements
| Platform | Cover Required | Notes |
|---|
| Kwai | Yes | Mandatory for all videos |
| Bilibili | Recommended | Improves click-through rate |
| YouTube | Recommended | Custom thumbnails increase views |
| TikTok | Optional | Auto-generated if not provided |
| Facebook | Optional | Recommended for better display |
Workflow
Step 1: Check if Thumbnail Needed
Determine if the target platform requires a cover image.
Step 2: Submit Extraction Task
Call createThumbnailTask with video URL.
Step 3: Poll for Results
- First check: Wait 15 seconds after submission
- Subsequent checks: Wait 10 seconds between polls
- Call
getThumbnailTaskStatus to check progress
Step 4: Return Results
On success, return the thumbnail URL for use as coverUrl.
Examples
Example 1: Extract for Publishing
User wants to publish video to Kwai without cover
1. createThumbnailTask:
- url: "https://example.com/video.mp4"
2. Wait 15 seconds
3. Poll getThumbnailTaskStatus until success
4. Use returned thumbnail URL as coverUrl
5. Proceed with createChannelPublishFlow
Example 2: Generate Cover Before Publishing
1. User provides video URL, title, description
2. Check if coverUrl is provided
3. If no coverUrl:
a. createThumbnailTask with videoUrl
b. Poll getThumbnailTaskStatus
c. Use returned thumbnail as coverUrl
4. Proceed with publishing
Task Status Values
| Status | Description |
|---|
| pending | Task created, waiting to start |
| processing | Task is actively extracting thumbnail |
| success | Thumbnail extracted successfully |
| failed | Task failed with error |
Important Notes
- Thumbnail extraction typically takes 10-15 seconds
- Always generate thumbnails for platforms that require covers (Kwai)
- Handle failures gracefully - inform user or use platform default
- Generated thumbnails can be used directly as coverUrl in publish tools
