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

OpenAI Sora

sora-2

OpenAI Sora — генерация видео от OpenAI, доступная через единый Ranvik API. Поддерживаемые возможности: async, image_to_video, text_to_video.

от 28 ₽ / сек

Карточка модели

Технические характеристики

МодальностьГенерация видео

Провайдерopenai

СтатусАктивна

ID для запросовsora-2

Возможности

Async
Image-to-video
Text-to-video

Цены

Единица	Цена
за секунду	28 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр Тип Диапазон / values Default Описание

promptrequired

string

min: 1 · max: 32000

—

Текстовое описание видео. До 32k символов.

примеры значений

Примеры

A calico cat playing a piano on stage, dramatic stage lighting.

input_reference

object

—

Опциональное reference изображение для guidance. Передать ОДИН из вариантов: {image_url} или {file_id}.

2 формата ввода

image_url variant

Поле	Тип	Значения	Описание
`image_url`req	string	—	URL or data: URL.

{
  "image_url": "https://example.com/ref.jpg"
}

file_id variant

Поле	Тип	Значения	Описание
`file_id`req	string	—	ID файла из OpenAI Files API.

{
  "file_id": "file-abc123"
}

seconds enum 4, 8, 12 4 Длительность видео в секундах. Только 4, 8 или 12.

size enum 720x1280, 1280x720, 1024x1792, 1792x1024 720x1280 Размер видео в формате WIDTHxHEIGHT.

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

Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.

720p portrait (9:16)

720×1280

720p landscape (16:9)

1280×720

1024 portrait (~4:7)

1024×1792

1024 landscape (~7:4)

1792×1024

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

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. Видео-генерация всегда async — нет sync-режима.

Поле	Тип	Значения	Описание
`id`	string	—	task_id для GET /v1/tasks/{id}.
`object`	string	video.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	video
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .mp4 / .webm / .mov.
`error`	string	—

Пример запроса

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "sora-2",
    prompt= "Пример промпта",
    input_reference= {},
    seconds= 4,
    size= "720x1280",
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: OpenAI

OpenAI — американская компания, создатель ChatGPT и серии моделей GPT. Один из лидеров индустрии генеративного ИИ. Модели OpenAI отличаются балансом скорости, качества и широкой поддержкой инструментов (function calling, vision, structured output).

Официальный сайт: https://openai.com

Документация модели у вендора: https://platform.openai.com/docs/api-reference/videos