Задачи генерации видео

Обзор API

Генерация видео выполняется асинхронно:

1. Вызов POST /v1/videos/tasks отправить задачу
2. Сохраните публичный ID задачи из ответа
3. Вызов GET /v1/tasks/{task_id} запросить статус и результаты

Base URL: https://api.rokoapi.com/v1. Все запросы должны содержать заголовок Authorization: Bearer $API_KEY.

Поддерживаемые модели

Фактический список доступных моделей определяется по /v1/models, конфигурации каналов в консоли и группе, к которой относится ключ API. Пользователь выбирает только модель продукта; RokoAPI автоматически выбирает маршрут генерации из текста, изображения, по образцу или редактирования в EvoLink на основе generation_type и полей с исходными материалами автоматически выбирает маршрут EvoLink: текст-в-видео, изображение-в-видео, видео по референсу или редактирование.

Генерация видео из текста

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

Генерация видео из изображения и по образцу

Обычно исходные материалы, доступные для прямой загрузки из публичной сети, передаются через image_urls, video_urls и audio_urls :

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

Исключение: генерация видео из изображения в Wan 2.7 использует image_start и необязательный image_end; Grok 1.5 автоматически выбирает режим на основе количества image_urls (0 — из текста, 1 — из изображения, 2–7 — по образцу) и не принимает параметр aspect_ratio.

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

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

В режиме редактирования Wan 2.7 значение duration: 0 означает, что длительность следует за входным видео. При редактировании в Gemini Omni длительность также следует за входным видео; не передавайте параметры duration или aspect_ratio.

Ограничения параметров

Дополнительные параметры модели из запроса передаются в EvoLink в исходной JSON-структуре, включая negative_prompt, generate_audio, content_filter, sound, prompt_extend и model_params. RokoAPI предварительно проверяет известные ограничения, такие как длительность, качество изображения, соотношение сторон, количество материалов и адрес обратного вызова. В видеоинтерфейсах не поддерживается n.

Обратные вызовы и опросы

Необязательный callback_url должен быть публичным HTTPS-адресом, длиной не более 2048 символов, и не может указывать на localhost или внутренний IP-адрес. Даже при настройке обратного вызова рекомендуется оставить опрос как резервный механизм:

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

Типичные состояния включают queued, in_progress, completed и failed. Ссылки на результаты могут иметь срок действия; в продакшене их следует своевременно скачивать и перемещать.

Тарификация

Модели используют единую тарификацию v2 в долларах США, позволяющую в одной формуле учитывать длительность вывода, длительность входного референсного видео, количество входных изображений, переключатель аудио, разрешение, качество, способ генерации и потребление токенов. При отправке производится предварительное списание на основе проверенных параметров; после завершения задачи окончательный расчет производится по фактическому количеству токенов или длительности вывода.

Ниже приведена фиксированная цена на 2026-08-20, включающая 10% сервисный сбор от публичной стоимости EvoLink; все цены указаны в долларах США. Цены не меняются в реальном времени в зависимости от баллов провайдера; администраторы обновляют эту таблицу и выражения в панели управления после проверки изменений цен провайдером.

Серия Seedance 2.0

Акционные цены для Fast и Mini основаны на изменении цен EvoLink от 2026-08-07. После окончания акции цены RokoAPI не меняются автоматически; в этом случае действуют новые значения из панели управления после проверки.

Другие видео-модели с тарификацией по секундам

Kling O3 тарифицируется одновременно по разрешению и переключателю звука:

Серия Sora 2

Цены на токены Gemini Omni

Длительность референсного видео учитывается в итоговом расчёте только после проверки метаданных медиафайла системой или получения достоверного объёма данных. Актуальные цены указаны на странице тарифов и в текущей конфигурации панели управления. Источники цен от провайдера можно найти в каталоге моделей EvoLink и на страницах документации по каждой модели.