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

Parameters: prompt, imageUrls (1-2), aspectRatio (16:9, 9:16, Auto), seeds, enableTranslation, watermark

OpenAI Sora 2

Parameters: prompt, aspect_ratio, n_frames, remove_watermark, character_id_list

Kling 2.5 / 2.6

Parameters: prompt, image_urls, sound, aspect_ratio, duration

Wan 2.2 / 2.5 / 2.6

Parameters: prompt, duration, resolution

Hailuo 2.3

Parameters: prompt, image_url, end_image_url, duration, resolution, prompt_optimizer

ByteDance Seedance 1.5

Parameters: prompt, input_urls, aspect_ratio, resolution, duration, fixed_lens, generate_audio

Grok Imagine

Workflow

Step 1: Check Credits

Always check your available credits before generating:

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:

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

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)

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