Vidu API SDKs for JavaScript, Python, Ruby, Go, Java, and PHP on RunAPI.

Create image-to-video or reference-to-video tasks, retrieve their status, or use run to poll until completion. Validation runs on the RunAPI server.

npm install @runapi.ai/vidu

Set RUNAPI_API_KEY in your environment. Replace the example image URL with a publicly accessible reference image.

import { ViduClient } from '@runapi.ai/vidu';

const client = new ViduClient(); // reads RUNAPI_API_KEY
const result = await client.referenceToVideo.run({
  model: 'vidu-q4-reference-to-video',
  prompt: 'Animate the referenced scene with a slow camera pan',
  reference_image_urls: ['https://cdn.runapi.ai/public/samples/image.jpg'],
  audio: false,
});
console.log(result.videos);

Use create to submit without waiting and get to retrieve the task by ID. Reference generation requires a prompt and 1–15 image URLs; it also accepts up to 3 MP3 reference audio URLs. Images must be JPG/JPEG/PNG/WEBP, at most 50 MB each; MP3 references must be 3–12 seconds and at most 50 MB each. Remote file properties are checked during provider processing, so a task can fail asynchronously.

See the API reference and SDK guide. For current pricing, use the canonical model pages: image-to-video and reference-to-video.