Wan 3.0 Video SDK (wan-3-video)

The official JavaScript/TypeScript client library for Wan 3.0 Video — an advanced multimodal AI video creation platform and document-to-video studio.

Generate cinematic, photorealistic video clips from text prompts, static images, reference frames, and long-form documents.

🌟 Key Features

• Text-to-Video Generation: Convert descriptive prompts into fluid, coherent videos with natural camera motion.
• Image-to-Video (I2V): Animate photos and key art with cinematic dynamics.
• Document-to-Video: Transform outlines, scripts, and documents into visual storytelling.
• Wan 3.0 Architecture: State-of-the-art visual fidelity, temporal consistency, and resolution control.
• Full TypeScript Support: Complete type definitions included out-of-the-box.
• Zero Heavy Dependencies: Lightweight, cross-platform runtime for Node.js, Next.js, and edge environments.

📦 Installation

npm install wan-3-video

Or using pnpm / yarn:

pnpm add wan-3-video
# or
yarn add wan-3-video

🚀 Quickstart

1. Basic Text-to-Video

import { WanVideoClient } from 'wan-3-video';

const client = new WanVideoClient({
  apiKey: process.env.WAN_API_KEY, // Or pass directly
});

async function main() {
  // Submit a video generation request
  const task = await client.generateVideo({
    prompt: "Cinematic drone shot of an ancient mountain sanctuary surrounded by misty waterfalls, 4k ultra-detailed, golden hour",
    aspectRatio: "16:9",
    duration: 5,
  });

  console.log("Task submitted successfully:", task.taskId);

  // Wait for rendering to complete
  const result = await client.waitForCompletion(task.taskId);
  console.log("Video ready:", result.videoUrl);
}

main();

2. Image-to-Video Animation

import { WanVideoClient } from 'wan-3-video';

const client = new WanVideoClient();

async function animateArtwork() {
  const task = await client.imageToVideo({
    imageUrl: "https://example.com/character-portrait.png",
    prompt: "Subtle breathing, eyes blinking naturally, cinematic camera slowly pushing in with soft depth of field",
    aspectRatio: "16:9",
  });

  const finalVideo = await client.waitForCompletion(task.taskId);
  console.log("Rendered video:", finalVideo.videoUrl);
}

animateArtwork();

🔗 Official Links & Resources

• Official Web Platform: https://aiwan.video
• Document to Video Studio: https://aiwan.video/wan-3-0-document-to-video
• Interactive Generator: https://aiwan.video/#generator
• Customer Support: [email protected]

📄 License

MIT © Wan 3.0 Video