npm install zyka-sdk

yarn add zyka-sdk

pnpm add zyka-sdk

npm install zod

# 1. Install the CLI the skill drives
npm install -g zyka

# 2. Set your API key (get one at https://zyka.ai)
export ZYKA_API_KEY=zk_live_...

# 3. Confirm it works
zyka auth whoami

/plugin marketplace add kshitijdixit/zyka-sdk
/plugin install zyka-sdk@zyka

codex plugin marketplace add kshitijdixit/zyka-sdk
codex plugin add zyka-sdk@zyka

git clone https://github.com/kshitijdixit/zyka-sdk
mkdir -p ~/.cursor/plugins/local
cp -R zyka-sdk ~/.cursor/plugins/local/zyka-sdk

curl -fsSL https://dev.meta.ai/install.sh | sh    # macOS and Linux
muse --version

muse plugins marketplace add zyka https://github.com/kshitijdixit/zyka-sdk
muse plugins install zyka-sdk@zyka
muse plugins list

git clone https://github.com/kshitijdixit/zyka-sdk
cd zyka-sdk
muse skills list      # zyka-ai appears

Generate a video of a sunset over mountains using WAN
Create an image of a neon cyberpunk city with Nano Banana and save it to ./city.png
Make a talking head video from ./face.jpg and ./speech.mp3
Dub ./demo.mp4 into Hindi using HeyGen
Transcribe ./meeting.mp3 and write the transcript to ./notes.txt
Upscale ./photo.jpg to 4k
Read the script in ./script.txt out loud with ElevenLabs

zyka generate image -m nano_banana -p "neon cyberpunk city" -o ./city.png
zyka generate video -m wan -p "sunset over mountains" -o ./video.mp4
zyka generate tts --script "Hello world" --voice-id abc123 -o ./speech.mp3
zyka generate transcription --audio ./meeting.mp3 -o ./transcript.txt

export ZYKA_API_KEY=zk_live_your_api_key_here

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient({
  apiKey: "zk_live_your_api_key_here",
});

const { ZykaClient } = require("zyka-sdk");

const client = new ZykaClient({
  apiKey: process.env.ZYKA_API_KEY,
});

async function main() {
  const result = await client.createImage(
    {
      model: "gpt_image_1",
      prompt:
        "A cinematic product photo of a silver smartwatch on a black studio background",
      size: "1024x1024",
    },
    {
      output: "./outputs/watch.png",
    },
  );

  console.log(result.id);
  console.log(result.status);
  console.log(result.outputUrl);
}

main().catch(console.error);

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient({
  apiKey: process.env.ZYKA_API_KEY,
});

async function main() {
  const video = await client.createVideo({
    model: "wan",
    prompt: "A cinematic drone shot over snow-covered mountains at sunrise",
    duration: 5,
  });

  console.log(video.outputUrl);
}

main().catch(console.error);

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient();

const image = await client.createImage(
  {
    model: "nano_banana",
    prompt: "A neon cyberpunk street market in heavy rain",
    size: "1024x1024",
  },
  {
    output: "./outputs/cyberpunk.png",
  },
);

console.log(image.outputUrl);

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient();

const video = await client.createVideo(
  {
    model: "kling",
    sub_model: "kling-v2-master",
    prompt:
      "A luxury perfume bottle rotating on a reflective surface with soft studio lighting",
    duration: "5",
    aspect_ratio: "16:9",
  },
  {
    output: "./outputs/perfume.mp4",
  },
);

console.log(video.status);
console.log(video.outputUrl);

// Local paths in reference_*_urls are auto-uploaded
const clip = await client.createVideo(
  {
    model: "minimax",
    sub_model: "minimax-h3-max",
    prompt: "The character from the reference walks through a busy Tokyo crossing at night",
    reference_image_urls: ["./char-front.png", "./char-side.png"],
    reference_video_urls: ["./walk-cycle.mp4"],
    duration: 10,
    resolution: "768P",
    aspect_ratio: "adaptive",
  },
  { output: "./outputs/tokyo.mp4" },
);

// WAN 3.0 image-to-video with native audio (2–30s, up to 1080p)
await client.createVideo({
  model: "wan",
  sub_model: "wan-3-0",
  prompt: "Camera orbits the sports car as it idles, engine rumble",
  start_image_url: "./car.jpg",
  duration: 12,
  resolution: "1080p",
  audio: true,
});

// grok_imagine v2, qwen_image_3, seedream_v5_pro, mai_image_2_5_pro (and gpt_image_2)
// switch to edit mode when image_list is present. A single `image` is auto-promoted.
await client.createImage(
  {
    model: "seedream_v5_pro",
    prompt: "Put the subject in a red trench coat, keep the pose",
    image_list: ["./ref1.jpg", "./ref2.jpg"],
    size: "auto_2K",
  },
  { output: "./outputs/coat.png" },
);

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient();

const audio = await client.createTTS(
  {
    provider: "elevenlabs",
    voice_id: "your_voice_id",
    script: "Welcome to Zyka SDK. Let us build AI media workflows faster.",
  },
  {
    output: "./outputs/voiceover.mp3",
  },
);

console.log(audio.outputUrl);

import { ZykaClient, asset } from "zyka-sdk";

const client = new ZykaClient();

const edited = await client.createImage({
  model: "nano_banana",
  image: "./assets/source-photo.jpg",
  prompt: "Turn this portrait into a high-fashion editorial photo",
});

const animated = await client.createVideo({
  model: "wan",
  sub_model: "wan-2-6-i2v",
  image_url: asset("hero.jpg"),
  prompt: "Subtle camera push-in with cinematic motion",
  duration: 5,
});

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient();

const pending = await client.createVideo(
  {
    model: "wan",
    prompt: "A futuristic city skyline during golden hour",
    duration: 5,
  },
  {
    waitForCompletion: false,
  },
);

console.log(`Queued job: ${pending.id}`);

const completed = await client.pollUntilComplete(pending.id, "video", {
  timeoutMs: 10 * 60 * 1000,
  pollIntervalMs: 3000,
});

console.log(completed.outputUrl);

import { composition, scene, render, renderImage, renderTTS } from "zyka-sdk";

const SocialClip = composition({
  id: "social-clip",
  scenes: [
    scene("image", ({ config }) =>
      renderImage(
        {
          model: "gpt_image_1",
          prompt: "A bold campaign poster for a sneaker brand",
        },
        config,
      ),
    ),
    scene("voice", ({ config }) =>
      renderTTS(
        {
          provider: "elevenlabs",
          voice_id: "voice_id",
          script: "New drop. Limited release. Available now.",
        },
        config,
      ),
    ),
  ],
});

await render(SocialClip, {}, undefined, {
  onSceneProgress(sceneId, result) {
    console.log(sceneId, result.status);
  },
  onSceneComplete(sceneId, result) {
    console.log(sceneId, result.outputUrl);
  },
});

import { ZykaClient } from "zyka-sdk";

const client = new ZykaClient();

try {
  const result = await client.createImage({
    model: "gpt_image_1",
    prompt: "Minimal product photography for a ceramic mug",
  });

  console.log(result.outputUrl);
} catch (error) {
  if (error instanceof Error) {
    console.error("Zyka request failed:", error.message);
  } else {
    console.error("Unknown error:", error);
  }
}

import { composition, scene, render, renderImage, renderTTS } from "zyka-sdk";
import { z } from "zod";

const Promo = composition({
  id: "promo",
  inputSchema: z.object({
    prompt: z.string(),
    script: z.string(),
    voiceId: z.string(),
  }),
  scenes: [
    scene("hero-image", ({ inputs, config }) =>
      renderImage(
        {
          model: "gpt_image_1",
          prompt: inputs.prompt,
        },
        config,
      ),
    ),
    scene("voiceover", ({ inputs, config }) =>
      renderTTS(
        {
          provider: "elevenlabs",
          voice_id: inputs.voiceId,
          script: inputs.script,
        },
        config,
      ),
    ),
  ],
});

const result = await render(Promo, {
  prompt: "A premium travel campaign poster for Iceland",
  script: "Adventure starts where the road ends.",
  voiceId: "voice_id",
});

console.log(result.scenes["hero-image"].outputUrl);

const client = new ZykaClient({ apiKey: 'zk_live_...' });
await client.createVideo({
  model: 'wan',
  sub_model: 'wan-2-7',
  prompt: 'a sunset',
  duration: 99,  // not supported
});
// console.warn: [zyka-sdk] duration=99s is not in the supported list for 'wan-2-7'. Supported: '5', '10', '15'.

const client = new ZykaClient({
  apiKey: 'zk_live_...',
  onWarning: (msg) => myLogger.warn(msg),
});

const client = new ZykaClient({ apiKey: 'zk_live_...', disableWarnings: true });

const cfg = client.getModelConfig('bytedance', 'OmniHuman v1.5');
console.log(cfg?.audio_duration_limit_1080p);  // 30
console.log(cfg?.resolutions);                  // ['720p', '1080p']

import { BYTEDANCE_VIDEO_CONFIG, getVideoModelConfig, validateVideoParams } from 'zyka-sdk';

const { warnings } = validateVideoParams({ model: 'wan', sub_model: 'wan-2-7', duration: 99 });

// HeyGen — lip-sync dubbing
await client.createVideoDubbing({ video_url: './video.mp4', model: 'heygen', output_language: 'Hindi (India)', mode: 'precision' });

// ElevenLabs — high-quality voice dubbing
await client.createVideoDubbing({ video_url: './video.mp4', model: 'elevenlabs', output_language: 'hi', highest_resolution: true });

// Sarvam — multi-language Indian dubbing
await client.createVideoDubbing({ video_url: './video.mp4', model: 'sarvam', output_language: 'Hindi,Tamil', genre: 'education' });

// Fetch supported languages
const langs = await client.getVideoDubbingLanguages('heygen');

npx zyka auth login
npx zyka auth whoami
npx zyka auth logout
npx zyka init my-zyka-project
npx zyka render ./dist/promo.js --inputs '{"prompt":"A cinematic launch video"}'
npx zyka generate image -m gpt_image_1 -p "A luxury watch ad" -o ./watch.png
npx zyka generate video -m wan -p "A drone shot over mountains" -d 5 -o ./mountains.mp4
npx zyka generate video -m minimax -s minimax-h3 -p "Slow dolly-in on the lighthouse" --image ./start.jpg --end-image ./end.jpg -d 8 --resolution 2K -o ./lighthouse.mp4
npx zyka generate video -m wan -s wan-3-0 -p "Recreate the dance with this person" --reference-images ./person.png --reference-videos ./dance.mp4 -d 6 -o ./dance.mp4
npx zyka generate image -m seedream_v5_pro -p "Red trench coat, keep the pose" --image-list ./ref1.jpg ./ref2.jpg --size auto_2K -o ./coat.png
npx zyka generate tts --provider elevenlabs --voice-id VOICE_ID --script "Welcome to Zyka" -o ./voice.mp3

zyka-sdk/
├── examples/
│   ├── product-ad/
│   └── social-video/
├── packages/
│   ├── cli/
│   │   ├── src/
│   │   │   └── commands/
│   │   └── skills/
│   └── core/
│       ├── src/
│       └── skills/
├── skills/
├── package.json
├── pnpm-workspace.yaml
└── tsconfig.json

export ZYKA_API_KEY=zk_live_your_api_key_here

const client = new ZykaClient({ timeoutMs: 10 * 60 * 1000 });

npx tsc
npx zyka render dist/my-composition.js --inputs '{}'

pnpm install
pnpm build
pnpm test