README

VimQu PHP-SDK

With this SDK you can change the container (mp4, mkv, mov, webm), codec (h264, h265, vp8, vp9, prores) and bitrate of video files. You can create Adaptive Bitrate videos. While doing this, you can resize, crop, clip operations on the video. You can create thumbnails from video file. Create subtitle files (WebVTT, SRT) in 94 languages (AI generated). Uploads the output files to the storage service of your choice.

Currently, VimQu is integrated with the following storage services:

• AWS S3
• Google Cloud Storage
• Azure Storage
• FTP
• Any S3 Compatible Service like Vultr Object Storage, DigitalOcean Object Storage, Wasabi, Backblaze ...

See Full documentation.

Requirements

• PHP 8.1+
• VimQu Account. Create account
• VimQu Token.
• Storage Service (you have to save it in VimQu). You can create it in this page and you can find how to add storage in this page

Installation

composer require vimqu/php-sdk

Quick Start

To create a Task we need a TaskManager instance.

use Vimqu\Vimqu\Task\TaskManager;
use Vimqu\Vimqu\Outputs\VideoOutput;

$task = TaskManager::withToken('your_access_token')
    ->setInputFromStorage('your_storage_id', '/birds.mp4');
	// or
    ->setInputFromUrl('https://<your_file>.mp4');

$video = (new VideoOutput('h264', 'mp4'))
    ->setStorage('your_storage_id', '/outputs/videos')
    ->setReferenceId('your_reference_id')
    ->subtitle(true)
    ->resize(300, null)
    ->clip(2, duration: 45)
    ->crop(300, 300, 15, 15);

$task->addOutput($video);
$result = $task->send();

You can add more than one output. If there is no error, the result will be the Vimqu\Vimqu\Dto\TaskDto instance.

$status = $result->getStatus(); // the status will be "active".
$id = $result->getId(); 

We will send you a request (webhook) when the task is complete. However, you can get the task result at any time.

use Vimqu\Vimqu\Task\Search;

// This query will give you the "TaskDto" instance again.
$task = Search::withToken('xxxx xxxx')->getById($id);

Task

API Document

Create HLS

use Vimqu\Vimqu\Outputs\HlsOutput;

$hls = (new HlsOutput)
    ->setStorage('your_storage_id', '/outputs/hls')
    ->setReferenceId('your_reference_id')
    ->subtitle(true)
    ->clip(2, 45)
    ->crop(300, 300, 15, 15)
    ->overlayImage('https://your_overlay_image.png', 50, 50, 0, 20)
    ->addVariant('240p')
    ->addVariant('480p')
    ->addVariant('720p')
    ->addVariant('1080p');

// $task is instance of TaskManager, we created it before.
$task->addOutput($hls);
$task->send();

• Available variants: 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p
• Available filters: clip, crop, subtitle, overlayImage

Create Mpeg DASH

use Vimqu\Vimqu\Outputs\DashOutput;

$dash = (new DashOutput)
    ->setStorage('your_storage_id', '/outputs/dash')
    ->setReferenceId('your_reference_id')
    ->subtitle(true)
    ->clip(2, 45)
    ->crop(300, 300, 15, 15)
    ->addVariant('720p')
    ->addVariant('1080p');

$task->addOutput($dash);
$task->send();

• Available variants: 240p, 360p 480p, 720p, 1080p, 1440p, 2160p
• Available filters: clip, crop, subtitle, overlayImage

Create Video Output

use Vimqu\Vimqu\Outputs\VideoOutput;

$video = (new VideoOutput('h264', 'mp4'))
    ->setStorage('your_storage_id', '/outputs/videos')
    ->setReferenceId('your_reference_id')
    ->subtitle(true)
    ->resize(300, null)
    ->clip(2, duration: 45)
    ->crop(300, 300, 15, 15);

$task->addOutput($video);
$task->send();

• Available containers: mp4, webm, mov, mkv
• Available video codecs: h264, h265, vp8, vp9, prores
• Available filters: resize, clip, crop, subtitle, overlayImage

Create Thumbnail with Exact Seconds

use Vimqu\Vimqu\Outputs\ThumbnailBySeconds;

$thumbnailBySeconds = (new ThumbnailBySeconds([4, 22, 400, 650]))
    ->setStorage('your_storage_id', '/outputs/thumbnails/seconds')
    ->setReferenceId('your_reference_id')
    ->resize(300, null);

$task->addOutput($thumbnailBySeconds);
$task->send();

• Available containers: jpg, png, webp
• Available filters: resize

Create Thumbnail with Number

use Vimqu\Vimqu\Outputs\ThumbnailByNumber;

$thumbnailByNumber = (new ThumbnailByNumber(5, 'jpg'))
    ->setStorage('your_storage_id', '/outputs/thumbnails/number')
    ->setReferenceId('your_reference_id')
    ->resize(300, 500, true);

$task->addOutput($thumbnailByNumber);
$task->send();

• Available containers: jpg, png, webp
• Available filters: resize

Create Thumbnail with Interval

use Vimqu\Vimqu\Outputs\ThumbnailByInterval;

$thumbnailByInterval = (new ThumbnailByInterval(10, 'png'))
    ->setStorage('your_storage_id', '/outputs/thumbnails/interval')
    ->setReferenceId('your_reference_id')
    ->resize(null, 150);

$task->addOutput($thumbnailByInterval);
$task->send();

• Available containers: jpg, png, webp
• Available filters: resize

Storage

You can fetch all storages. Details

use Vimqu\Vimqu\Storage;

$storages = Storage::withToken($token)->all();
// [
//    [
//         'name' => 'my_storage',
//         'id' => 'xxxx xxxx xxxx',
//         'driver' => 's3' // it can be ftp, gcs, azure
//    ]
// ]

Search Task

This method will get you all your tasks. The result is an array of TaskDto.

use Vimqu\Vimqu\Task\Search;

$tasks = Search::withToken($token)->search();

You can apply these filters:

$tasks = Search::withToken($token)->search(
	['hls', 'thumbnail', 'dash'],
	'your_reference_id',
	'completed'
);

Result of the Search (the TaskDto)

foreach($tasks as $task) {

    $taskStatus = $task->getStatus();
    $id = $task->getId();

    foreach($task->getOutputs() as $output) {

        $reference = $output->getReferenceId();

        foreach($output->getFiles() as $file){
            $filePath = $file->getPath();
        }
    }
}

• Vimqu\Vimqu\Dto\FileDto
• Vimqu\Vimqu\Dto\OutputDto
• Vimqu\Vimqu\Dto\TaskDto

Filters Reference

resize

You can use it to rescale the video.

clip

You can create clips from any time in the video.

overlayImage

You can use it to burn pictures on video.

crop

You can cut the video at specific points.

subtitle

You can use it to create a transcript. Your vtt and srt files will be in targetPath root directory. You gave this directory in the setStorage method.