kie-video-generator

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

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

python scripts/generate_video.py --list-models

Step 3: Generate Video

Interactive mode (recommended for first-time users):

python scripts/generate_video.py "your prompt here"

The script will:

Display your current credits
Show available models with costs
Ask you to select a model
Confirm before generating
Poll for completion and download

Direct mode (when you know the model):

python scripts/generate_video.py "your prompt" --model veo3-fast

Step 4: Image-to-Video

For models that support image input:

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

python scripts/generate_video.py "cinematic landscape" \
  --model veo3 \
  --aspect-ratio 16:9 \
  --seed 12345

Kling 2.6:

python scripts/generate_video.py "dancing robot" \
  --model kling-2.6-t2v \
  --duration 10 \
  --sound

Wan 2.6:

python scripts/generate_video.py "flowing water" \
  --model wan-2.6-t2v \
  --duration 15 \
  --resolution 1080p

Seedance:

python scripts/generate_video.py "product showcase" \
  --model seedance-1.5-pro \
  --duration 8 \
  --aspect-ratio 16:9 \
  --generate-audio

Output Options

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

KIE_AI_API_KEY=your_api_key_here

Or use the centralized auth:

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)

About this skill