runapi-ai / vidu

v0.1.0 2026-10-15 02:30 UTC

Requires

• php: >=8.2
• runapi-ai/core: ^0.10.0

Requires (Dev)

• phpunit/phpunit: ^11.5

Apache-2.0

• RunAPI

• php
• api
• composer
• sdk
• packagist
• runapi
• runapi-ai
• vidu
• vidu-api

Published on Packagist.org on 2026-10-15 02:41 UTC

README

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.

Install

composer require runapi-ai/vidu

Quick start

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

<?php
require 'vendor/autoload.php';

$client = new \RunApi\Vidu\ViduClient(); // reads RUNAPI_API_KEY
$result = $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,
]);

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.

Source repository: https://github.com/runapi-ai/vidu-php. Licensed under the Apache License 2.0.