extracting-thumbnails

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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

1. First check: Wait **15 seconds** after submission
2. Subsequent checks: Wait **10 seconds** between polls
3. 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 publishPostToKwai
```

### 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

From Yusufkotavom/AiToEarn, MIT.

More from Yusufkotavom/AiToEarn