Используйте Sora 2 Pro через Rivya Public API v1: ID модели sora-2-pro, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIТекст или URL готовы; референсные режимы используют Files APIВидео

ID модели API

sora-2-pro

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

text, file

Files API

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

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

Возможность

Видео

Биллинг

FIXED

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

10000 символов

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

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

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

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

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
size	select	Нет	-	-	standard, high	Уровень качества
n_frames	select	Нет	10	-	10, 15	Длительность
aspect_ratio	select	Нет	landscape	-	landscape, portrait	Соотношение сторон
remove_watermark	select	Нет	false	-	false, true	Удалить водяной знак
upload_method	select	Нет	s3	-	s3, oss	Цель загрузки

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

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

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

Референсное изображение: Загрузите до 1 файла изображения для image-проектов.

Макс. файлов

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

image

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

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

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

Минимальный запрос

{
  "model": "sora-2-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

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

{
  "model": "sora-2-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_sora_2_pro_example",
  "status": "queued",
  "model": "sora-2-pro",
  "reserved_credits": 75,
  "final_credits": 0,
  "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.

Интеграция Sora 2 Pro API