Инструменты · key

`aivideo` Генерация и редактирование видео нейросетями

Ставит задачу ИИ-генератору видео: ролик по текстовому описанию, по опорному изображению или правка готового видео (tab=edit). Метод асинхронный: POST возвращает report_id, ссылку на ролик забирают тем же методом. Список нейросетей отдаёт вызов с models=1.

Режим: асинхронный: report_id
Стоимость: по модели, качеству и длительности; списывается при постановке
Тариф: только платные тарифы
Одновременно: не больше 5 активных задач

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

GET /api/aivideo

Нейросети, доступные вашему ключу. Задача не ставится, лимиты не списываются. Состав меняется без предупреждения — берите value отсюда.

Параметры query

models int обязательный

Любое непустое значение — вернуть справочник.

Ответ

models[].name string

Название модели в интерфейсе.
models[].value string

Значение для параметра model.
models[].promptLength int

Максимальная длина prompt; 0 — общий предел 2000 символов.
models[].isVideoEdit bool

Модель для редактирования готового видео (tab=edit).
default string

Модель, выбранная в инструменте по умолчанию.

GET /api/aivideo

curl -G 'https://tools.pixelplus.ru/api/aivideo' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'models=1'

<?php
$url = 'https://tools.pixelplus.ru/api/aivideo?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'models' => 1,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/aivideo",
    params={
        "key": "ВАШ_КЛЮЧ",
        "models": 1,
    },
    timeout=60,
)
print(response.json())

models обязательный Любое непустое значение — вернуть справочник

Запрос настоящий — выполнится с вашим ключом

Пример ответа

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

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

POST /api/aivideo

Ролик по описанию и, по желанию, опорному изображению. Параметры — полями формы (multipart/form-data, если загружаете файл), ключ — в адресе.

Параметры query и тело формы

prompt string обязательный

Описание сцены, до promptLength модели (по умолчанию 2000 символов). Без ссылок и параметров вида --param, проходит фильтр 18+.
model string обязательный

value из справочника, например sora-2, runway, grok-imagine.
aspect_ratio string

Соотношение сторон: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, portrait, landscape. Список общий, не все модели поддерживают все значения.

По умолчанию 1:1
quality string

Качество: 480p, 720p, 1080p или 4k. Влияет на цену.

По умолчанию 720p
duration int

Длительность в секундах. Допустимые значения зависят от модели, см. таблицу ниже; недопустимое молча заменяется значением по умолчанию модели. Влияет на цену.
image_url string

Ссылка на опорное изображение (.png, .jpg, .jpeg, .webp): ролик начнётся с него. Ресурс должен быть доступен по сети, локальные адреса не принимаются.
upload_image file

Опорное изображение файлом вместо ссылки.
audio_description string

Звук или музыка — дописывается к промпту. Не передавайте пустым; модель runway звук не поддерживает.

POST /api/aivideo

curl -X POST 'https://tools.pixelplus.ru/api/aivideo?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'prompt=Кот в наушниках диджеит на вечеринке' \
  --data-urlencode 'model=sora-2' \
  --data-urlencode 'aspect_ratio=16:9' \
  --data-urlencode 'quality=720p' \
  --data-urlencode 'duration=10'

<?php
$url = 'https://tools.pixelplus.ru/api/aivideo?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'prompt' => 'Кот в наушниках диджеит на вечеринке',
        'model' => 'sora-2',
        'aspect_ratio' => '16:9',
        'quality' => '720p',
        'duration' => 10,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/aivideo",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "prompt": "Кот в наушниках диджеит на вечеринке",
        "model": "sora-2",
        "aspect_ratio": "16:9",
        "quality": "720p",
        "duration": 10,
    },
    timeout=60,
)
print(response.json())

prompt обязательный Описание сцены, до promptLength модели (по умолчанию 2000 символов) model обязательный value из справочника, например sora-2, runway, grok-imagine aspect_ratio Соотношение сторон: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, portrait, landscape quality Качество: 480p, 720p, 1080p или 4k duration Длительность в секундах

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "report_id": 18452301
}

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

POST /api/aivideo

Правка готового ролика по описанию. Промпт перед отправкой переводится на английский; aspect_ratio, quality и duration в этом режиме не применяются.

Параметры query и тело формы

tab string обязательный

Всегда edit. Без него запрос считается генерацией.
model string обязательный

Модель с isVideoEdit=true; сейчас принимается только runway-aleph.
prompt string обязательный

Что изменить в ролике.
video_url string обязательный

Ссылка на исходное видео: mp4, mov, mkv, webm, avi, wmv, mpeg, mpg.

POST /api/aivideo

curl -X POST 'https://tools.pixelplus.ru/api/aivideo?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'tab=edit' \
  --data-urlencode 'model=runway-aleph' \
  --data-urlencode 'prompt=Сделай сцену ночной, с неоновой подсветкой' \
  --data-urlencode 'video_url=https://example.com/clip.mp4'

<?php
$url = 'https://tools.pixelplus.ru/api/aivideo?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'tab' => 'edit',
        'model' => 'runway-aleph',
        'prompt' => 'Сделай сцену ночной, с неоновой подсветкой',
        'video_url' => 'https://example.com/clip.mp4',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/aivideo",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "tab": "edit",
        "model": "runway-aleph",
        "prompt": "Сделай сцену ночной, с неоновой подсветкой",
        "video_url": "https://example.com/clip.mp4",
    },
    timeout=60,
)
print(response.json())

tab обязательный Всегда edit. Без него запрос считается генерацией model обязательный Модель с isVideoEdit=true; сейчас принимается только runway-aleph prompt обязательный Что изменить в ролике video_url обязательный Ссылка на исходное видео: mp4, mov, mkv, webm, avi, wmv, mpeg, mpg

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "report_id": 18452302
}

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

GET /api/aivideo

Повторяйте раз в 10–30 секунд: генерация видео занимает минуты. Задача, которую нейросеть не выполнила, тоже завершается — с success: false, лимиты за неё возвращаются.

Параметры query

report_id int обязательный

ID задачи из ответа на постановку. Передавайте в адресе.

Ответ

request object

Параметры задачи.
response.response object

Результат генерации.
Вложенные поля
- success bool
  
  Удалась ли генерация.
- data array
  
  Ссылки на готовое видео; пустой массив при неудаче.
- error string|null
  
  Текст ошибки нейросети.
- _meta object
  
  Служебные данные генерации.
time string

Время готовности.
cost int

Сейчас всегда 0 — см. примечание о стоимости.

GET /api/aivideo

curl -G 'https://tools.pixelplus.ru/api/aivideo' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=18452301'

<?php
$url = 'https://tools.pixelplus.ru/api/aivideo?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 18452301,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/aivideo",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18452301,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

Запрос настоящий — выполнится с вашим ключом

Пример ответа

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

Ошибки

Код	Сообщение	Когда
`-100`	`tools errors`	Задача не поставлена, причины в `details`: пустой или длинный промпт, ссылки или `--параметры` в нём, фильтр 18+, модель недоступна, недопустимые `aspect_ratio` или `quality`, звук с `runway`, нет или неверна ссылка на видео в `tab=edit`, бесплатный тариф, не хватает лимитов.
`-60`	`tools errors`	Уже 5 незавершённых задач (`MAX_PARALLEL_TASKS_FAIL`).
`-51`	`No requests data`	Задача ставится не POST-запросом.
`50`	`In progress`	Задача ещё идёт; `progress` — процент готовности.
`-4`	`Access denied`	`report_id` чужой или другого инструмента.
`-104…-107, -125`	`Processing error и др.`	Задача завершилась сбоем — см. асинхронные задачи.
`-68, -80…-83`	`Not enough … limits`	Лимиты закончились — метод не отвечает даже на справочник и чтение отчёта.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

Ответ с ошибкой

{
    "error": "tools errors",
    "details": [
        "Выбранная модель недоступна."
    ],
    "code": "-100"
}

Длительность по моделям

Модель (value содержит)	Допустимо, сек	По умолчанию
`sora-2`	10, 15	10
`grok-imagine`	6, 10, 15, 30	6
`gemini-omni`	4, 6, 8, 10	10
`runway`	5, 8	5
остальные	5, 10, 15	5

Стоимость

Цена берётся из прайс-правил инструмента по сочетанию model, quality и duration — от точного совпадения к более общим правилам. Правила хранятся в настройках, а не в коде; актуальные цены — в интерфейсе инструмента. Лимиты списываются при постановке и возвращаются, если генерация не удалась.

Цена считается по duration из запроса, а ролик генерируется с исправленной длительностью. Без duration цена считается как за 5 секунд, даже если модель снимет 10. Передавайте длительность явно и из допустимых для модели значений.

Поле cost в результате сейчас всегда 0, даже у удачной генерации, — ориентируйтесь на прайс в интерфейсе и историю списаний.

Ограничения

В режиме tab=edit через API передавайте ссылку video_url: загрузка файла upload_video не проходит проверку и вернёт ошибку.
Ссылки на результат не вечны — скачивайте ролик сразу.

aivideo Генерация и редактирование видео нейросетями

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

Параметры query

Ответ

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

Параметры query и тело формы

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

Параметры query и тело формы

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

Параметры query

Ответ

Ошибки

Длительность по моделям

Стоимость

Ограничения

`aivideo` Генерация и редактирование видео нейросетями