dantelabs-agentic-school 1.0.0 → 1.2.0

package/plugins/common/skills/kie-video-generator/SKILL.md

@@ -0,0 +1,258 @@
+---
+name: kie-video-generator
+description: Generate AI videos using Kie.ai's diverse video generation models including Veo 3, Sora 2, Kling, Wan, Hailuo, Seedance, and more. Supports text-to-video, image-to-video, and video extension with automatic usage tracking and model comparison.
+---
+
+# Kie Video Generator
+
+## Overview
+
+Generate high-quality AI videos using Kie.ai's comprehensive collection of video generation models. This skill provides access to 15+ state-of-the-art models including Google Veo 3/3.1, OpenAI Sora 2, Kling 2.5/2.6, Wan 2.2/2.5/2.6, Hailuo, ByteDance Seedance, and more.
+
+**Features:**
+- Text-to-video and image-to-video generation
+- Automatic credit usage tracking and reporting
+- Model cost comparison before generation
+- Interactive model selection
+- Video extension capabilities
+
+## Quick Start
+
+```bash
+# Check available credits
+python scripts/generate_video.py --credits
+
+# List all available models with pricing
+python scripts/generate_video.py --list-models
+
+# Generate video with interactive model selection
+python scripts/generate_video.py "a serene sunset over the ocean"
+
+# Generate with specific model
+python scripts/generate_video.py "cyberpunk city at night" --model veo3
+
+# Image-to-video generation
+python scripts/generate_video.py "make this image come alive" --model kling-2.6-i2v --image https://example.com/image.jpg
+```
+
+## Supported Models
+
+### Google Veo 3 / 3.1
+| Model ID | Type | Duration | Resolution | Est. Cost |
+|----------|------|----------|------------|-----------|
+| `veo3` | Text/Image to Video | 8s | 1080P | $2.00 |
+| `veo3-fast` | Text/Image to Video | 8s | 1080P | $0.40 |
+
+**Parameters:** `prompt`, `imageUrls` (1-2), `aspectRatio` (16:9, 9:16, Auto), `seeds`, `enableTranslation`, `watermark`
+
+### OpenAI Sora 2
+| Model ID | Type | Frames | Resolution | Est. Cost |
+|----------|------|--------|------------|-----------|
+| `sora-2-t2v` | Text to Video | 10/15 | landscape/portrait | ~$1.00 |
+| `sora-2-pro-t2v` | Pro Text to Video | 10/15 | landscape/portrait | ~$2.00 |
+| `sora-2-i2v` | Image to Video | - | - | ~$1.50 |
+| `sora-2-watermark-remover` | Remove Watermark | - | - | ~$0.50 |
+
+**Parameters:** `prompt`, `aspect_ratio`, `n_frames`, `remove_watermark`, `character_id_list`
+
+### Kling 2.5 / 2.6
+| Model ID | Type | Duration | Resolution | Est. Cost |
+|----------|------|----------|------------|-----------|
+| `kling-2.6-t2v` | Text to Video | 5/10s | 1:1, 16:9, 9:16 | ~$0.50 |
+| `kling-2.6-i2v` | Image to Video | 5/10s | - | ~$0.60 |
+| `kling-2.5-t2v` | Text to Video | 5/10s | - | ~$0.40 |
+| `kling-2.1-master` | Master Text to Video | - | - | ~$0.80 |
+
+**Parameters:** `prompt`, `image_urls`, `sound`, `aspect_ratio`, `duration`
+
+### Wan 2.2 / 2.5 / 2.6
+| Model ID | Type | Duration | Resolution | Est. Cost |
+|----------|------|----------|------------|-----------|
+| `wan-2.6-t2v` | Text to Video | 5/10/15s | 720p/1080p | ~$0.30 |
+| `wan-2.5-t2v` | Text to Video | - | - | ~$0.25 |
+| `wan-2.2-t2v` | Text to Video | - | - | ~$0.20 |
+| `wan-2.2-animate` | Animate | - | - | ~$0.30 |
+
+**Parameters:** `prompt`, `duration`, `resolution`
+
+### Hailuo 2.3
+| Model ID | Type | Duration | Resolution | Est. Cost |
+|----------|------|----------|------------|-----------|
+| `hailuo-2.3-i2v-standard` | Image to Video (Standard) | 6/10s | 512P/768P | ~$0.30 |
+| `hailuo-2.3-i2v-pro` | Image to Video (Pro) | 6/10s | 512P/768P | ~$0.50 |
+| `hailuo-2.3-t2v-standard` | Text to Video (Standard) | - | - | ~$0.30 |
+
+**Parameters:** `prompt`, `image_url`, `end_image_url`, `duration`, `resolution`, `prompt_optimizer`
+
+### ByteDance Seedance 1.5
+| Model ID | Type | Duration | Resolution | Est. Cost |
+|----------|------|----------|------------|-----------|
+| `seedance-1.5-pro` | Pro Video | 4/8/12s | 480p/720p | ~$0.40 |
+| `seedance-v1-pro-t2v` | Pro Text to Video | - | - | ~$0.35 |
+| `seedance-v1-lite-i2v` | Lite Image to Video | - | - | ~$0.20 |
+| `seedance-v1-pro-i2v` | Pro Image to Video | - | - | ~$0.40 |
+| `seedance-v1-pro-fast-i2v` | Pro Fast Image to Video | - | - | ~$0.30 |
+
+**Parameters:** `prompt`, `input_urls`, `aspect_ratio`, `resolution`, `duration`, `fixed_lens`, `generate_audio`
+
+### Grok Imagine
+| Model ID | Type | Est. Cost |
+|----------|------|-----------|
+| `grok-imagine` | Text/Image to Video | ~$0.50 |
+
+## Workflow
+
+### Step 1: Check Credits
+
+Always check your available credits before generating:
+
+```bash
+python scripts/generate_video.py --credits
+```
+
+Output:
+```
+💰 Kie.ai Account Balance
+━━━━━━━━━━━━━━━━━━━━━━━━
+Available Credits: 1,250
+Estimated Value: $6.25 USD
+```
+
+### Step 2: Compare Models
+
+View all available models with estimated costs:
+
+```bash
+python scripts/generate_video.py --list-models
+```
+
+### Step 3: Generate Video
+
+**Interactive mode (recommended for first-time users):**
+```bash
+python scripts/generate_video.py "your prompt here"
+```
+
+The script will:
+1. Display your current credits
+2. Show available models with costs
+3. Ask you to select a model
+4. Confirm before generating
+5. Poll for completion and download
+
+**Direct mode (when you know the model):**
+```bash
+python scripts/generate_video.py "your prompt" --model veo3-fast
+```
+
+### Step 4: Image-to-Video
+
+For models that support image input:
+
+```bash
+# Single image
+python scripts/generate_video.py "animate this scene" \
+  --model kling-2.6-i2v \
+  --image https://example.com/image.jpg
+
+# First and last frame (Veo 3, Hailuo)
+python scripts/generate_video.py "transition between scenes" \
+  --model veo3 \
+  --image https://example.com/start.jpg \
+  --end-image https://example.com/end.jpg
+```
+
+## Advanced Usage
+
+### Model-Specific Parameters
+
+**Veo 3:**
+```bash
+python scripts/generate_video.py "cinematic landscape" \
+  --model veo3 \
+  --aspect-ratio 16:9 \
+  --seed 12345
+```
+
+**Kling 2.6:**
+```bash
+python scripts/generate_video.py "dancing robot" \
+  --model kling-2.6-t2v \
+  --duration 10 \
+  --sound
+```
+
+**Wan 2.6:**
+```bash
+python scripts/generate_video.py "flowing water" \
+  --model wan-2.6-t2v \
+  --duration 15 \
+  --resolution 1080p
+```
+
+**Seedance:**
+```bash
+python scripts/generate_video.py "product showcase" \
+  --model seedance-1.5-pro \
+  --duration 8 \
+  --aspect-ratio 16:9 \
+  --generate-audio
+```
+
+### Output Options
+
+```bash
+# Custom output directory
+python scripts/generate_video.py "prompt" --output ~/Videos/ai/
+
+# Custom filename
+python scripts/generate_video.py "prompt" --filename my_video
+```
+
+## Environment Setup
+
+Create `.env` file in the skill directory:
+
+```bash
+KIE_AI_API_KEY=your_api_key_here
+```
+
+Or use the centralized auth:
+```bash
+source ~/.claude/auth/kie-ai.env
+```
+
+## Cost Estimation
+
+Before each generation, the script shows estimated cost:
+
+```
+📊 Cost Estimate
+━━━━━━━━━━━━━━━━━━━━━━━━
+Model: veo3-fast
+Estimated Cost: ~80 credits ($0.40)
+Current Balance: 1,250 credits ($6.25)
+After Generation: ~1,170 credits ($5.85)
+
+Proceed with generation? [y/N]:
+```
+
+## Error Handling
+
+Common error codes:
+- **401**: Invalid API key
+- **402**: Insufficient credits
+- **422**: Invalid parameters
+- **429**: Rate limited (wait and retry)
+- **501**: Generation failed (try different prompt/model)
+
+## Resources
+
+### scripts/
+- `generate_video.py` - Main CLI with interactive model selection
+- `utils.py` - API utilities, polling, credit checking
+- `models/` - Model-specific parameter handlers
+
+### references/
+- `api_docs.md` - Complete API documentation
+- `models.md` - Detailed model specifications

package/plugins/common/skills/kie-video-generator/references/api_docs.md

@@ -0,0 +1,202 @@
+# Kie.ai Video API Documentation Reference
+
+## Base URL
+```
+https://api.kie.ai
+```
+
+## Authentication
+All requests require Bearer token:
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+## Unified Jobs API
+
+Most video models use the unified Jobs API pattern:
+
+### Create Task
+```
+POST /api/v1/jobs/createTask
+```
+
+Request body:
+```json
+{
+  "model": "model-id",
+  "callBackUrl": "optional-webhook-url",
+  "input": {
+    "prompt": "text description",
+    // model-specific parameters
+  }
+}
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "taskId": "task_xxx"
+  }
+}
+```
+
+### Query Task Status
+```
+GET /api/v1/jobs/recordInfo?taskId={taskId}
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "taskId": "task_xxx",
+    "model": "model-id",
+    "state": "success|waiting|queuing|generating|fail",
+    "resultJson": "{\"resultUrls\":[\"https://...\"]}",
+    "failCode": "",
+    "failMsg": "",
+    "costTime": 0,
+    "completeTime": 1698765432000,
+    "createTime": 1698765400000
+  }
+}
+```
+
+### Get Account Credits
+```
+GET /api/v1/chat/credit
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "msg": "success",
+  "data": 1250
+}
+```
+
+---
+
+## Veo 3 API
+
+### Generate Video
+```
+POST /api/v1/veo/generate
+```
+
+Parameters:
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| prompt | string | Yes | Video description |
+| model | enum | No | `veo3` or `veo3_fast` |
+| imageUrls | array | No | 1-2 reference images |
+| generationType | enum | No | TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO |
+| aspectRatio | enum | No | 16:9, 9:16, Auto |
+| seeds | integer | No | 10000-99999 |
+| callBackUrl | string | No | Webhook URL |
+| enableTranslation | boolean | No | Auto-translate prompt |
+| watermark | string | No | Watermark text |
+
+### Get Video Status
+```
+GET /api/v1/veo/record-info?taskId={taskId}
+```
+
+### Get 1080P Video
+```
+GET /api/v1/veo/get-1080p-video?taskId={taskId}
+```
+
+---
+
+## Model-Specific Parameters
+
+### Sora 2 (sora-2-text-to-video)
+| Parameter | Type | Options |
+|-----------|------|---------|
+| prompt | string | max 10,000 chars |
+| aspect_ratio | enum | landscape, portrait |
+| n_frames | enum | "10", "15" |
+| remove_watermark | boolean | - |
+
+### Kling 2.6 (kling-2.6/text-to-video)
+| Parameter | Type | Options |
+|-----------|------|---------|
+| prompt | string | max 1000 chars |
+| sound | boolean | - |
+| aspect_ratio | enum | 1:1, 16:9, 9:16 |
+| duration | enum | "5", "10" |
+
+### Wan 2.6 (wan/2-6-text-to-video)
+| Parameter | Type | Options |
+|-----------|------|---------|
+| prompt | string | max 5000 chars |
+| duration | enum | "5", "10", "15" |
+| resolution | enum | 720p, 1080p |
+
+### Hailuo (hailuo/02-image-to-video-standard)
+| Parameter | Type | Options |
+|-----------|------|---------|
+| prompt | string | max 1500 chars |
+| image_url | string | First frame |
+| end_image_url | string | Last frame |
+| duration | enum | "6", "10" |
+| resolution | enum | 512P, 768P |
+| prompt_optimizer | boolean | - |
+
+### Seedance 1.5 (bytedance/seedance-1.5-pro)
+| Parameter | Type | Options |
+|-----------|------|---------|
+| prompt | string | max 2500 chars |
+| input_urls | array | 0-2 images |
+| aspect_ratio | enum | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 |
+| resolution | enum | 480p, 720p |
+| duration | enum | 4, 8, 12 |
+| fixed_lens | boolean | - |
+| generate_audio | boolean | - |
+
+---
+
+## Error Codes
+
+| Code | Description |
+|------|-------------|
+| 200 | Success |
+| 401 | Unauthorized (invalid API key) |
+| 402 | Insufficient credits |
+| 404 | Not found |
+| 422 | Validation error |
+| 429 | Rate limited |
+| 455 | Service unavailable |
+| 500 | Server error |
+| 501 | Generation failed |
+| 505 | Feature disabled |
+
+---
+
+## Credit System
+
+- 1 credit = $0.005 USD
+- Credits are deducted upon task completion
+- Use GET /api/v1/chat/credit to check balance
+
+## Pricing Estimates
+
+| Model | Est. Credits | Est. USD |
+|-------|--------------|----------|
+| Veo 3 Quality | 400 | $2.00 |
+| Veo 3 Fast | 80 | $0.40 |
+| Sora 2 T2V | 200 | $1.00 |
+| Sora 2 Pro | 400 | $2.00 |
+| Kling 2.6 T2V | 100 | $0.50 |
+| Wan 2.6 T2V | 60 | $0.30 |
+| Hailuo Standard | 60 | $0.30 |
+| Seedance Pro | 80 | $0.40 |
+
+*Prices are estimates and may vary based on parameters.*