Generate AI videos, images, voice, and use AI apps using the Zyka CLI. Use when users want to create AI-generated media — videos (Sora, Veo, Kling, WAN, Seed...
SKILL.md

---
name: zyka-ai
version: 0.4.11
description: Generate AI videos, images, voice, and use AI apps using the Zyka CLI. Use when users want to create AI-generated media — videos (Sora, Veo, Kling, WAN, Seedance, Grok, LTX, Aurora), images (DALL·E, GPT Image, Flux, Nano Banana, Kling, Grok, Zyka Helion, Qwen), TTS (ElevenLabs, Chatterbox, Qwen3, MiniMax, Fish Audio), talking heads, or AI apps (upscale, face swap, captions, dubbing, etc.).
homepage: https://zyka.ai
repository: https://github.com/kshitijdixit/zyka-sdk
license: MIT
metadata:
  openclaw:
    emoji: "🎬"
    requires:
      env: [ZYKA_API_KEY]
      bins: [zyka]
    primaryEnv: ZYKA_API_KEY
    install:
      - id: npm
        kind: node
        package: zyka
        bins: [zyka]
        label: "Install Zyka CLI (npm)"
---

<!-- zyka-skill-version: 0.4.11 -->

# Zyka AI Media Generation

Generate AI videos, images, voice, and use AI-powered apps directly from the terminal using the `zyka` CLI. One command, 40+ AI models. No code writing required.

## Setup

The `zyka` CLI is published on npm: https://www.npmjs.com/package/zyka
Source: https://github.com/kshitijdixit/zyka-sdk

**Required: install the CLI once before using this skill.** All examples below assume `zyka` is on your PATH.

```bash
npm install -g zyka            # one-time install (latest)
zyka --help                    # verify install
```

Set your API key (required — get one at https://zyka.ai/settings/api-keys):
```bash
export ZYKA_API_KEY=zk_live_...
```

## Security & Privacy

Before using this skill, understand what runs and where data flows:

- **Local install required:** the skill calls the locally installed `zyka` binary. No remote code is fetched at runtime. Install pulls the latest published version from npm (https://www.npmjs.com/package/zyka); inspect the package source at https://github.com/kshitijdixit/zyka-sdk before installing if you want stronger assurance.
- **Outbound data flow:** any local files you reference (images, audio, video) are uploaded to Zyka's API. Zyka proxies generation requests to third-party model providers (OpenAI, Google, ByteDance, ElevenLabs, Kling, etc.). Do not pass private personal data, proprietary content, credentials, or files you don't want third parties to see. Review https://zyka.ai privacy/terms for retention and downstream-provider policies.
- **API key handling:** treat `ZYKA_API_KEY` as a service secret. Use a least-privilege key, never commit it, and rotate or delete it when no longer needed. Monitor usage in your Zyka dashboard.
- **Autonomous use:** this skill is designed for agent-driven invocation. The agent can call Zyka endpoints (and spend credits) without an extra prompt once the skill is enabled. If you want explicit user confirmation per call, run commands interactively rather than relying on autonomous invocation.

## CRITICAL: Always use CLI commands, never write code scripts

When a user asks to generate media, **run the `zyka generate` command directly** — do NOT write JavaScript files. The CLI handles file uploads, waiting, and downloading.

---

## Generate Videos

```bash
zyka generate video -m MODEL -p "prompt" [options]
```

### Video Models

| Model | `-m` value | Key options |
|---|---|---|
| OpenAI Sora | `sora` | `-s sora-2`, `-d 4/8/12`, `--size 1280x720` |
| Google Veo | `veo` | `-s veo-3.1-generate-001`, `-d 4-8`, `-a 16:9/9:16`, `--size 720p/1080p/4k` |
| Kling AI | `kling` | `-s kling-v2-master`, `-d 5/10`, `-a 16:9`, `--mode std/pro` |
| Kling V3 | `kling` | `-s kling-v3` or `kling-v3-pro`, `-d 3-15`, `--first-frame ./img.jpg` |
| Kling O3 | `kling` | `-s kling-o3` or `kling-o3-pro`, `-d 3-15` |
| Kling Omni | `kling` | `-s kling-video-o1`, `-d 3-10` |
| Kling Multi-Image | `kling` | `-s multi-image-to-video` (pass image_list via SDK) |
| ByteDance Seedance V1.5 Pro | `bytedance` | `-s "Seedance V1.5 Pro"`, `-d 4-12`, `--resolution 720p` |
| ByteDance Seedance 2.0 | `bytedance` | `-s "Seedance 2.0"`, `-d 4-12`, `--resolution 720p` |
| ByteDance Seedance 2.0 Fast | `bytedance` | `-s "Seedance 2.0 Fast"`, `-d 4-12`, `--resolution 720p` |
| ByteDance OmniHuman | `bytedance` | `-s "OmniHuman"`, `--image ./face.jpg --audio ./speech.mp3` |
| ByteDance OmniHuman v1.5 | `bytedance` | `-s "OmniHuman v1.5"`, `--image ./face.jpg --audio ./speech.mp3` |
| Alibaba WAN T2V | `wan` | `-s wan-2-6-t2v`, `-d 5/10/15`, `--size 1280*720` |
| Alibaba WAN 2.7 | `wan` | `-s wan-2-7`, `-d 5/10/15`, `--size 1280*720` |
| Alibaba WAN I2V | `wan` | `-s wan-2-6-i2v`, `--image ./img.jpg`, `-d 5/10/15` |
| Alibaba WAN I2V 2.5 | `wan` | `-s wan-2-5-i2v`, `--image ./img.jpg`, `-d 5/10/15` |
| WAN Animate Replace | `wan` | `-s wan-v2-2-animate-replace`, `--video ./vid.mp4 --image ./char.png` |
| WAN Animate Move | `wan` | `-s wan-v2-2-animate-move`, `--video ./vid.mp4 --image ./char.png` |
| Talking Head | `infinite_talk` | `--image ./face.jpg --audio ./speech.mp3` |
| Aurora (Lip Sync) | `aurora` | `--video ./face.mp4 --audio ./speech.mp3`, `--audio-guidance-scale 7` |
| LTX Video T2V | `ltx` | `-s ltx-2.3-text-to-video` |
| LTX Video I2V | `ltx` | `-s ltx-2.3-image-to-video`, `--image ./img.jpg` |
| Grok Video | `grok` | `-s grok-imagine-video`, `-d 1-15`, `--resolution 720p` |

### Video Examples

**Text to video:**
```bash
zyka generate video -m wan -p "A cinematic sunset over mountains" -d 5 -o ./sunset.mp4
```

**Image to video (animate a photo):**
```bash
zyka generate video -m kling -s kling-v2-master -p "gentle zoom in with wind" --image ./photo.jpg -d 5 -a 16:9 --mode pro -o ./animated.mp4
```

**Talking head (lip sync):**
```bash
zyka generate video -m infinite_talk -p "lip sync" --image ./face.jpg --audio ./speech.mp3 -o ./talking.mp4
```

**Aurora lip sync (video + audio):**
```bash
zyka generate video -m aurora --video ./face.mp4 --audio ./speech.mp3 -o ./lipsync.mp4
```

**First/last frame interpolation:**
```bash
zyka generate video -m veo -s veo-3.1-generate-001 -p "smooth transition" --first-frame ./start.jpg --last-frame ./end.jpg -d 8 -a 16:9 -o ./transition.mp4
```

**LTX video:**
```bash
zyka generate video -m ltx -s ltx-2.3-text-to-video -p "A flowing river through autumn forest" -o ./ltx.mp4
```

**Grok video:**
```bash
zyka generate video -m grok -p "Medieval knight in mystical forest" -d 6 --resolution 720p -o ./knight.mp4
```

**WAN animate replace (swap character in video):**
```bash
zyka generate video -m wan -s wan-v2-2-animate-replace --video ./original.mp4 --image ./new-character.png -o ./swapped.mp4
```

---

## Generate Images

```bash
zyka generate image -m MODEL -p "prompt" [options]
```

### Image Models

| Model | `-m` value | Notes |
|---|---|---|
| Nano Banana | `nano_banana` | `-s nano-banana-1` (default), `nano-banana-pro` (4K), `nano-banana-2` (fast 4K) |
| DALL·E 2 | `dall_e_2` | `--size 256x256/512x512/1024x1024` |
| DALL·E 3 | `dall_e_3` | `--quality standard/hd`, `--style vivid/natural` |
| GPT Image 1 | `gpt_image_1` | `--background transparent`, `--quality auto/low/medium/high` |
| GPT Image 1 Mini | `gpt_image_1_mini` | Cheaper variant |
| GPT Image 1.5 | `gpt_image_1_5` | Latest OpenAI |
| Flux Schnell | `flux_1_schnell` | Fast |
| Flux 2 Dev | `flux_2_dev` | High quality |
| Flux 2 Klein 9B | `flux_2_klein_9b` | Compact high quality |
| Kling Image | `kling` | `-s kling-v1`, `kling-v2`, `kling-image-v3`, `kling-image-v3-text-to-image`, `omni-image`, `kling-image-o1`, `multi-image-to-image` |
| SD XL | `stable_diffusion_xl_base_1_0` | `--negative-prompt "blurry"` |
| SD img2img | `stable_diffusion_v1_5_img2img` | Needs `--image` |
| Lucid Origin | `lucid_origin` | Leonardo AI |
| Phoenix 1.0 | `phoenix_1_0` | Leonardo AI |
| Zyka Helion | `zyka_helion` | Fast Zyka-native |
| Grok Imagine | `grok_imagine` | xAI Grok |
| Qwen Image 2 Pro | `qwen_image_2_pro` | Chinese/English support |
| Z Image Turbo | `z_image_turbo` | Fast |

### Image Examples

**Generate from text:**
```bash
zyka generate image -m gpt_image_1 -p "A neon cyberpunk cityscape" -o ./city.png
```

**Edit an existing image:**
```bash
zyka generate image -m nano_banana -s nano-banana-pro -p "make the hair straight" --image ./me.png -o ./result.png
```

**4K high-res image:**
```bash
zyka generate image -m nano_banana -s nano-banana-2 -p "cinematic portrait" --resolution 4K --size 5504x3072 -o ./portrait.png
```

**Transparent background:**
```bash
zyka generate image -m gpt_image_1 -p "product photo of sneakers" --background transparent -o ./sneakers.png
```

**Grok image:**
```bash
zyka generate image -m grok_imagine -p "Abstract golden particles, data visualization style" -o ./abstract.png
```

**Qwen image:**
```bash
zyka generate image -m qwen_image_2_pro -p "A serene mountain landscape at sunset" -o ./landscape.png
```

**Zyka Helion (fast):**
```bash
zyka generate image -m zyka_helion -p "cyberpunk cat in neon city" -o ./cat.png
```

---

## Generate Text-to-Speech

```bash
zyka generate tts --script "text" [options]
```

### TTS Providers

| Provider | `--provider` value | Notes |
|---|---|---|
| ElevenLabs | `elevenlabs` | Needs `--voice-id` |
| Qwen3 | `qwen3` | Voice design/clone/custom |
| Chatterbox | `chatterbox` | Clone + emotion tags `[happy]`, `[sad]`, `[angry]`, `[calm]` |
| VoxCPM | `voxcpm` | Voice cloning only (requires reference audio) |
| MiniMax | `minimax` | 17 preset voices (Wise_Woman, Friendly_Person, Deep_Voice_Man, etc.) |
| MOSS-TTS | `moss-tts` | RunPod-based |
| Fish Audio | `fish-audio` | Instant voice cloning |

### TTS Examples

**Generate speech:**
```bash
zyka generate tts --provider elevenlabs --voice-id VOICE_ID --script "Welcome to Zyka" -o ./speech.mp3
```

**Clone a voice:**
```bash
zyka generate tts --provider chatterbox --voice ./my-voice.mp3 --script "[happy] This sounds like me!" -o ./cloned.mp3
```

**Fish Audio:**
```bash
zyka generate tts --provider fish-audio --voice ./sample.wav --script "Hello world" -o ./fish.mp3
```

**MiniMax preset voice:**
```bash
zyka generate tts --provider minimax --script "Hello! Welcome to MiniMax TTS." -o ./minimax.mp3
```

**MiniMax with emotion and stereo:**
```bash
zyka generate tts --provider minimax --script "Hello!" --emotion happy --channel 2 -o ./minimax.mp3
```

---

## AI Apps (via SDK)

These apps are available through the `ZykaClient` SDK:

```js
const { ZykaClient } = require('zyka-sdk');
const client = new ZykaClient();
```

### Image Apps
| App | Method | Params |
|---|---|---|
| Upscale | `createUpscale()` | `{ image, resolution: '1k'/'2k'/'4k' }` |
| Face Swap | `createFaceSwap()` | `{ type: 'image'/'video', url, face_image }` |
| Virtual Try-On | `createVirtualTryOn()` | `{ human_image, cloth_image }` |
| Outfit Swap | `createOutfitSwap()` | `{ user_image, character_image }` |
| Skin Enhancer | `createSkinEnhancer()` | `{ image, type: 'perfect_skin'/'realistic_skin'/'imperfect_skin' }` |
| Behind the Scene | `createBehindTheScene()` | `{ image, type: 'image'/'video' }` |
| Camera Angles | `createAngles()` | `{ image, angle: { azimuth, elevation } }` |
| 9 Shorts | `createNineShorts()` | `{ image }` |
| Zooms | `createZooms()` | `{ image }` |
| Story Generator | `createStoryGenerator()` | `{ image }` |
| Holi Special | `createHoliSpecial()` | `{ image }` |
| Simple App | `createSimpleApp()` | `{ image, app_id?, prompt? }` |

### Video Apps
| App | Method | Params |
|---|---|---|
| Caption Generator | `createCaptionGenerator()` | `{ url, language?, caption_style? }` |
| Video to Script | `createVideoToScript()` | `{ url, script_style?: 'general'/'screenplay'/'blog_post'/'social_media'/'documentary' }` |
| Video Cleaner | `createVideoCleaner()` | `{ url, language? }` |
| Video Upscaler | `createVideoUpscaler()` | `{ video_url, target_resolution: '1080p'/'2k'/'4k', target_fps: '30fps'/'60fps' }` |
| Video Dubbing (HeyGen) | `createVideoDubbing()` | `{ video_url, model: 'heygen', output_language: 'Hindi (India)', mode?, enable_caption?, enable_speech_enhancement?, translate_audio_only? }` |
| Video Dubbing (ElevenLabs) | `createVideoDubbing()` | `{ video_url, model: 'elevenlabs', output_language: 'hi', source_lang?, num_speakers?, highest_resolution?, drop_background_audio?, use_profanity_filter? }` |
| Video Dubbing (Sarvam) | `createVideoDubbing()` | `{ video_url, model: 'sarvam', output_language: 'Hindi' (or comma-separated), source_lang?, num_speakers?, genre?: 'general'/'news'/'entertainment'/'education'/'sports'/'religious' }` |
| Dubbing Languages | `getVideoDubbingLanguages(model)` | model: `'heygen'`/`'elevenlabs'`/`'sarvam'` — returns supported languages |
| Short Video Creator | `createShortVideoCreator()` | `{ url, clip_duration_sec: 'auto'/5/15/30/45 }` |
| B-roll | `createBroll()` | `{ url, broll_duration_sec?: 'auto'/2-10 }` |
| YouTube Downloader | `createYouTubeDownloader()` | `{ url, quality?: '720p', format?: 'mp4' }` |
| Voice Changer | `createVoiceChanger()` | `{ source_audio_url, target_voice_url?, voice_strength? }` |
| Image to SVG | `createImageToSvg()` | `{ image_url }` |

### CLI App Commands
```bash
zyka generate upscale --image ./photo.jpg --resolution 4k -o ./upscaled.jpg
zyka generate face-swap --type image --url ./target.jpg --face ./face.jpg -o ./result.jpg
zyka generate skin-enhancer --image ./photo.jpg --type perfect_skin -o ./enhanced.jpg
zyka generate virtual-try-on --human ./me.jpg --cloth ./dress.jpg -o ./tryon.jpg
zyka generate outfit-swap --user-image ./me.jpg --character-image ./celeb.jpg -o ./outfit.jpg
zyka generate behind-the-scene --image ./photo.jpg --type image -o ./scene.jpg
zyka generate nine-shorts --image ./photo.jpg -o ./angles.jpg
zyka generate zooms --image ./photo.jpg -o ./zooms.jpg
zyka generate story-generator --image ./photo.jpg -o ./story.jpg
zyka generate holi-special --image ./photo.jpg -o ./holi.jpg
zyka generate simple-app --image ./photo.jpg --app-id my-app -o ./result.jpg
zyka generate caption --url ./video.mp4 --language en -o ./captioned.mp4
zyka generate video-to-script --url ./video.mp4 --script-style screenplay -o ./script.txt
zyka generate video-cleaner --url ./video.mp4 -o ./cleaned.mp4
zyka generate video-upscaler --url ./video.mp4 --resolution 4k -o ./upscaled.mp4
zyka generate video-dubbing --url ./video.mp4 --model heygen --language "Hindi (India)" --mode precision -o ./dubbed.mp4
zyka generate video-dubbing --url ./video.mp4 --model elevenlabs --language hi --source-lang en --num-speakers 2 --highest-resolution -o ./dubbed.mp4
zyka generate video-dubbing --url ./video.mp4 --model sarvam --language "Hindi,Tamil" --genre education -o ./dubbed.mp4
zyka generate short-video --url ./long.mp4 --duration auto -o ./clips/
zyka generate broll --url ./video.mp4 -o ./with-broll.mp4
zyka generate youtube-download --url "https://youtube.com/watch?v=..." --quality 720p -o ./video.mp4
zyka generate voice-changer --audio ./input.mp3 --voice ./reference.mp3 -o ./output.mp3
zyka generate image-to-svg --image ./photo.png -o ./result.svg
```

---

## Guidelines

- **ALWAYS use `zyka generate` CLI commands** — never write JavaScript files
- Set `ZYKA_API_KEY` env var before running commands
- Use `-o ./filename` to save results to disk (auto-downloads)
- Use `--image ./path` to pass local image files (auto-uploads)
- Use `--audio ./path` to pass local audio files (auto-uploads)
- Use `--video ./path` to pass local video files (auto-uploads)
- All commands auto-wait for completion — no polling needed
- When editing images, default to `-m nano_banana -s nano-banana-pro`
- When generating videos from text, default to `-m wan`
- When animating images to video, default to `-m kling -s kling-v2-master`
- When generating 4K images, use `-m nano_banana -s nano-banana-2 --resolution 4K`
- For fast image generation, use `-m zyka_helion` or `-m flux_1_schnell`
- For transparent backgrounds, use `-m gpt_image_1 --background transparent`

## CLI Options Reference

| Flag | Description |
|---|---|
| `-m, --model` | Model name (required for video/image) |
| `-p, --prompt` | Text prompt (required) |
| `-s, --sub-model` | Model variant |
| `-d, --duration` | Video duration in seconds |
| `-a, --aspect-ratio` | Aspect ratio (16:9, 9:16, 1:1) |
| `--size` | Output size (e.g. 1024x1024, 720p) |
| `--image` | Input image path (for editing/animating) |
| `--audio` | Input audio path (for talking heads) |
| `--video` | Input video path (for V2V) |
| `-o, --output` | Save result to this file path |
| `--no-wait` | Don't wait for completion |
| `--negative-prompt` | What to avoid in generation |
| `--mode` | Kling mode: std or pro |
| `--resolution` | Resolution: 480p, 720p, 1080p, 1K, 2K, 4K |
| `--first-frame` | First frame image (Kling, Veo 3.1, Bytedance) |
| `--last-frame` | Last frame image (Kling, Veo 3.1, Bytedance) |
| `--quality` | Quality: standard, hd, auto, low, medium, high |
| `--background` | GPT Image background: transparent, opaque, auto |
| `--style` | DALL-E 3 style: vivid, natural |
| `-n, --count` | Number of images to generate |
| `--title` | Title for the generation job |
| `--audio-guidance-scale` | Aurora lip sync guidance (0-10) |
| `--emotion` | MiniMax TTS emotion (neutral/happy/sad/angry/fearful/disgusted/surprised) |
| `--channel` | MiniMax TTS audio channel (1=mono, 2=stereo) |
Zyka AI

SKILL.md

related skills
