Kie AI

kie.ai Media Generation

Generate video, audio, and images using kie.ai's unified API for Veo3.1, Runway, Luma, Suno, GPT-4o, and Flux Kontext.

Environment Setup

export KIE_AI_API_KEY="your_api_key"
export KIE_AI_POLL_INTERVAL=5      # Optional: seconds between polls (default: 5)
export KIE_AI_MAX_POLL_ATTEMPTS=120 # Optional: max poll attempts (default: 120)

Quick Reference

Video Generation

Veo3.1 (Google)

python skills/kie-ai/scripts/video/veo_generate.py \
  --prompt "A cat playing piano in a jazz club" \
  --model veo3 \
  --aspect-ratio "16:9"

Options: --model veo3|veo3_fast, --aspect-ratio, --image-urls, --get-hd, --no-poll

Runway

python skills/kie-ai/scripts/video/runway_generate.py \
  --prompt "Drone shot over mountain peaks at sunrise" \
  --duration 10 \
  --quality 1080p

Options: --duration 5|10, --quality 720p|1080p, --aspect-ratio, --image-url

Extend: python skills/kie-ai/scripts/video/runway_extend.py --task-id TASK_ID

Luma (Video Modification)

python skills/kie-ai/scripts/video/luma_modify.py \
  --prompt "Add lens flare and cinematic color grading" \
  --video-url "https://..."

Audio Generation (Suno)

Generate Music

python skills/kie-ai/scripts/audio/suno_generate.py \
  --prompt "Upbeat jazz with piano and saxophone" \
  --model V4_5 \
  --style "jazz, piano, upbeat"

Options: --model V3_5|V4|V4_5|V4_5PLUS|V4_5ALL|V5, --custom-mode, --instrumental, --title

Additional Audio Operations

Image Generation

GPT-4o

python skills/kie-ai/scripts/image/gpt4o_generate.py \
  --prompt "Abstract digital art with vibrant neon colors" \
  --size "16:9" \
  --variants 2

Options: --size 1:1|3:2|2:3, --variants 1|2|4, --files-url (up to 5), --mask-url, --enhance

Flux Kontext

python skills/kie-ai/scripts/image/flux_generate.py \
  --prompt "Professional product photo on marble surface" \
  --model flux-kontext-max \
  --aspect-ratio "4:3"

Options: --model flux-kontext-pro|flux-kontext-max, --output-format jpeg|png, --input-image

File Upload

# Base64 upload (up to 10MB)
python skills/kie-ai/scripts/upload/upload_base64.py --file /path/to/file

# Stream upload (multipart)
python skills/kie-ai/scripts/upload/upload_stream.py --file /path/to/file

# URL upload (up to 100MB)
python skills/kie-ai/scripts/upload/upload_url.py --url "https://..."

Uploaded files expire in 3 days.

Bulk Operations

Batch Generation

Create config file:

{
  "requests": [
    {"id": "vid_001", "endpoint": "veo", "params": {"prompt": "...", "model": "veo3"}},
    {"id": "img_001", "endpoint": "gpt4o", "params": {"prompt": "...", "size": "1:1"}},
    {"id": "mus_001", "endpoint": "suno", "params": {"prompt": "...", "model": "V4_5"}}
  ]
}

Run batch:

python skills/kie-ai/scripts/bulk/bulk_generate.py \
  --config bulk_config.json \
  --batch-size 5

Check Multiple Tasks

python skills/kie-ai/scripts/bulk/bulk_status.py \
  --task-ids "task1,task2,task3" \
  --endpoint veo

Output Format

All scripts return:

{
  "success": true,
  "task_id": "xxx",
  "status": "success",
  "output_files": ["output/file.mp4"],
  "summary": "Video generated: 1 file(s) downloaded"
}

All files (raw responses, summaries, and generated media) are saved to ./output/ by default. Override with --output-dir.

Important Notes

• Rate Limits: 20 requests per 10 seconds (automatic throttling)
• Download URLs: Expire in 20 minutes (auto-downloaded by scripts)
• Generated Media: Retained 14 days
• Uploaded Files: Retained 3 days
• Polling: Automatic with exponential backoff (5s to 30s intervals)

For detailed API parameters and error codes, see references/api_reference.md.