ГлавнаяМоделиГенерация видеоOpenAI Sora

OpenAI Sora API

deprecated
ПровайдерOpenai

sora-2 — генерация видео-модель от Openai.

asyncimage_to_videotext_to_video

Что умеет OpenAI Sora

  • Async
  • Видео из изображения
  • Видео по тексту

Стоимость

за секунду
13.21 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

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

Vendor
openai
Modality
video

OpenAI Sora API для генерации видео

OpenAI Sora — модель генерации видео от OpenAI, представленная в феврале 2024 года. Ее особенность — создание роликов по тексту, изображениям и видео с учетом движения, композиции и сцен. В технической основе — диффузионный трансформер, обрабатывающий визуальные данные как пространственно-временные патчи. Через Ranvik API можно работать без VPN и оплачивать доступ в рублях.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
promptreq
string
min: 1 · max: 32000
—
Текстовое описание видео. До 32k символов.
1 пример
Примеры
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_urlreqstring—URL or data: URL.
{
  "image_url": "https://example.com/ref.jpg"
}
file_id variant
ПолеТипЗначенияОписание
file_idreqstring—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
—

Пример кода

sora-2_example.py
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)
Полная документация модели

Частые вопросы о OpenAI Sora

OpenAI Sora — модель для генерации видео по текстовым запросам, изображениям и роликам. Через Ranvik API ее удобно подключать к своим продуктам без VPN.
Модель помогает быстрее создавать визуальные концепты, рекламные ролики и контент для проектов. Ranvik API упрощает доступ и интеграцию в рабочие процессы.
Подключение доступно через Ranvik API: сервис предоставляет удобный доступ к моделям для разработки и контент-задач без необходимости использовать VPN.
Зарегистрируйтесь в Ranvik API, получите ключ и подключите его к своему приложению. Сервис позволяет работать с API из России без VPN.
Да, в Ranvik API доступна оплата в российских рублях. Это делает подключение и пополнение баланса удобнее для пользователей из России.
OpenAI Sora использует диффузионный трансформер и пространственно-временные патчи для обработки визуальных данных, помогая формировать цельные видеосцены.