Extracting Thumbnails
Documentsextracting-thumbnailsExtracting Thumbnails is an Agent Skill for documents published in the yikart/AiToEarn repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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). 提取封面、视频封面、生成封面、缩略图提取、视频缩略图、截取封面。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/yikart/AiToEarn/blob/HEAD/project/aitoearn-backend/apps/aitoearn-ai/src/core/agent/skills/extracting-thumbnails/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/extracting-thumbnails, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 |
| 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
getThumbnailTaskStatusto 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