Используйте Vidu Q4 через Rivya Public API v1: ID модели vidu-q4, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIГотовностьВидео

ID модели API

vidu-q4

Входные данные

file

Files API

Требуется для референсных режимов

Базовые кредиты

Ставка в кредитах: 7,2–62,4 / секунду результата Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Видео

Биллинг

METERED

Лимит промпта

20000 символов

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	vidu-q4	Используйте vidu-q4 как ID модели API.
prompt	string	Да	-	Максимум 20000 символов для этой модели.
params	object	Да	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
resolution	select	Нет	720p	-	540p, 720p, 1080p, 2k, 4k	Разрешение
duration	number	Нет	5	min 3 / max 16 / step 1	-	Длительность
audio	select	Нет	true	-	true, false	Создать аудио

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Референсное изображение: Загрузите одно начальное изображение JPEG, PNG или WebP размером до 50 MB.

Макс. файлов

Принимаемые типы файлов

image

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kind	Макс. размер	MIME-типы
image	48 MB	image/jpeg, image/png, image/webp

Для этой модели не показан запускаемый пример Public API.

Запрос с референсным файлом

{
  "model": "vidu-q4",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "audio": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_vidu_q4_example",
  "status": "queued",
  "model": "vidu-q4",
  "reserved_credits": 76,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Некоторым режимам нужны референсные файлы, загруженные через Files API.

Интеграция Vidu Q4 API