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

OpenAI Sora

ПровайдерOpenai

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

asyncimage_to_videotext_to_video

Попробуйте прямо здесь

OpenAI Sora Открыть в Playground

Что умеет OpenAI Sora

  • Async
  • Image-to-video
  • Text-to-video

Стоимость

за секунду
28 ₽

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

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

Vendor
openai
Modality
video

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
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)
Полная документация модели