Документация на метод "aivideo"

Как это работает

• 1 Берём модель из справочника — вызываем метод с models=1. Видеомодели обновляются чаще остальных, а от выбранной модели зависят допустимая длительность и поддержка звука.
• 2 Ставим задачу — POST с промптом и моделью. В ответ приходит report_id. Лимиты списываются в момент создания задачи.
• 3 Забираем результат — периодически (раз в 10–15 секунд) запрашиваем метод с report_id, пока вместо In progress не придёт ссылка на готовое видео.

1Справочник моделей

/api/aivideo?models=1 — возвращает нейросети, доступные вашему ключу. Задача не создаётся, лимиты не списываются.

Ответ

{
  "models": [
    {
      "name": "Runway",
      "value": "runway",
      "promptLength": 1000,
      "isVideoEdit": false
    },
    {
      "name": "Sora 2",
      "value": "sora-2",
      "promptLength": 0,
      "isVideoEdit": false
    },
    {
      "name": "Runway Aleph",
      "value": "runway-aleph",
      "promptLength": 0,
      "isVideoEdit": true
    }
  ],
  "default": "runway"
}

2Постановка задачи

POST /api/aivideo — параметры передаются телом запроса (multipart/form-data, если прикладываете файл).

Генерация видео

Редактирование готового видео

Режим включается параметром tab=edit и работает только с моделями, у которых isVideoEdit=true.

Ответ

{
  "report_id": 18452301
}

3Получение результата

GET /api/aivideo?report_id={id} — вызывается, пока задача не завершится. Повторные запросы бесплатны.

Задача ещё выполняется

{
  "error": "In progress",
  "code": 50,
  "progress": 10,
  "time": "2026-02-11 14:32:07"
}

Пример результата

{
  "request": {
    "model": "sora-2",
    "prompt": "Кот в наушниках диджеит на вечеринке",
    "aspect_ratio": "16:9",
    "quality": "720p",
    "duration": 10
  },
  "response": {
    "success": true,
    "error": null,
    "data": [
      "https://tools.pixelplus.ru/storage/ai-video/vid_65f2c1a9.mp4"
    ]
  },
  "time": "2026-02-11 14:36:41",
  "cost": 1200
}

Тарификация

Стоимость определяется комбинацией model, quality и duration: у моделей свои прайс-правила, более высокое качество и большая длительность дороже. Если генерация завершилась неудачей, списанные лимиты возвращаются на счёт, а в ответе приходит cost: 0. Фактическое списание всегда видно в поле cost вместе с результатом.

Если доступных лимитов не хватает, задача не создаётся: в ответе придут код ошибки и точные значения available / need.

Коды ошибок

Основные сообщения валидации в details

• Введите запрос, пожалуйста. и Уменьшите размер запроса до {N} символов, пожалуйста.;
• Выберите модель нейросети, пожалуйста. и Выбранная модель недоступна.;
• Выберите соотношение сторон, пожалуйста. и Выберите качество видео, пожалуйста.;
• Модель Runway не поддерживает звук… — audio_description с несовместимой моделью;
• Уберите из запроса параметры, пожалуйста… и Уберите из запроса ссылки, пожалуйста.;
• Исправьте запрос — фильтр 18+.;
• Укажите ссылку на видео или загрузите файл., Размер загруженного видео не должен превышать 10 МБ., Недопустимый формат видео. — режим tab=edit;
• Данный метод доступен только платным тарифам!.

Примеры

cURL

# 1. Справочник моделей
curl 'https://tools.pixelplus.ru/api/aivideo?key={ключ-api}&models=1'

# 2. Постановка задачи
curl -X POST 'https://tools.pixelplus.ru/api/aivideo?key={ключ-api}' \
  -d 'model=sora-2' \
  -d 'aspect_ratio=16:9' \
  -d 'quality=720p' \
  -d 'duration=10' \
  --data-urlencode 'prompt=Кот в наушниках диджеит на вечеринке'

# 3. Результат
curl 'https://tools.pixelplus.ru/api/aivideo?key={ключ-api}&report_id=18452301'

PHP

<?php

$key = '{ключ-api}';
$base = 'https://tools.pixelplus.ru/api';

function apiRequest(string $url, array $data = null): array
{
    $curl = curl_init();
    $options = [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 300,
    ];
    if ($data !== null) {
        $options[CURLOPT_POST] = true;
        $options[CURLOPT_POSTFIELDS] = $data;
    }
    curl_setopt_array($curl, $options);
    $response = curl_exec($curl);
    curl_close($curl);

    return json_decode($response, true) ?: [];
}

// 1. Берём модель из справочника
$catalog = apiRequest("{$base}/aivideo?key={$key}&models=1");
$model = $catalog['default'];

// 2. Ставим задачу
$task = apiRequest("{$base}/aivideo?key={$key}", [
    'model'        => $model,
    'prompt'       => 'Кот в наушниках диджеит на вечеринке',
    'aspect_ratio' => '16:9',
    'quality'      => '720p',
]);

if (empty($task['report_id'])) {
    exit('Ошибка: ' . json_encode($task, JSON_UNESCAPED_UNICODE));
}

// 3. Ждём результат — генерация видео идёт минутами
do {
    sleep(15);
    $result = apiRequest("{$base}/aivideo?key={$key}&report_id={$task['report_id']}");
} while (($result['code'] ?? null) === 50);

print_r($result['response']['data']);

Python

import time
import requests

KEY = '{ключ-api}'
BASE = 'https://tools.pixelplus.ru/api'

catalog = requests.get(f'{BASE}/aivideo', params={'key': KEY, 'models': 1}).json()

task = requests.post(
    f'{BASE}/aivideo',
    params={'key': KEY},
    data={
        'model': catalog['default'],
        'prompt': 'Кот в наушниках диджеит на вечеринке',
        'aspect_ratio': '16:9',
        'quality': '720p',
    },
).json()

while True:
    result = requests.get(
        f'{BASE}/aivideo',
        params={'key': KEY, 'report_id': task['report_id']},
    ).json()
    if result.get('code') != 50:
        break
    time.sleep(15)

print(result['response']['data'])
print('Списано лимитов:', result['cost'])

Редактирование готового ролика

<?php
// Модель должна иметь isVideoEdit=true в справочнике

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://tools.pixelplus.ru/api/aivideo?key={ключ-api}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'tab'    => 'edit',
        'model'  => 'runway-aleph',
        'prompt' => 'Замени фон на зимний город',
        'upload_video' => new CURLFile('/path/to/clip.mp4'),
        // либо ссылкой:
        // 'video_url' => 'https://example.com/clip.mp4',
    ],
]);
echo curl_exec($curl);
curl_close($curl);

Ограничения и рекомендации

• Модель берите из справочника models=1: состав зависит от тарифа ключа и обновляется чаще, чем у остальных ИИ-инструментов.
• Опрашивайте результат не чаще одного раза в 10 секунд — генерация видео занимает минуты.
• Не больше 5 одновременно выполняющихся задач на пользователя.
• Допустимые значения duration зависят от модели, а неподходящее значение подменяется молча — сверяйтесь с таблицей выше.
• Звук через audio_description поддерживают не все модели: с runway запрос будет отклонён.
• Ссылки и параметры вида --param в промпте запрещены, текст проходит фильтр 18+.
• Готовый результат хранится в истории инструмента: один и тот же report_id можно запрашивать сколько угодно раз бесплатно. Сам файл скачивайте сразу — ссылки не вечны.