Sora 2 Генерация видео

Обзор

Sora 2 — флагманская серия генерации видео OpenAI, создающая клипы длительностью 4–12 секунд с высоким качеством и синхронизированным звуком по prompt или референсным изображениям. APIYI предоставляет прозрачный прокси-канал (официальный релей), который напрямую пересылает запросы в эндпоинт OpenAI /v1/videos с идентичной семантикой запроса и ответа.

🎬 Основные возможности: Прозрачный прокси к официальному OpenAI API, синхронизированный вывод аудио и видео, гибкая длительность 4 / 8 / 12 секунд и три уровня разрешения — Standard (720p), HD (1024p) и Full HD (1080p, только Pro). Подходит для рекламных коротких роликов, материалов для e-commerce, клипов для соцсетей и демонстраций продуктов, где важны точное следование инструкциям и стабильное качество.

API преобразования текста в видео

POST /v1/videos, генерируйте видео только по prompt — тело запроса JSON, самый простой вариант входа.

API изображения в видео

POST /v1/videos + multipart-загрузка input_reference, чтобы анимировать статичное изображение в клип.

Визуальное тестирование API

Отлаживайте этот эндпоинт напрямую в инструменте визуального тестирования iCover — код не требуется.

Асинхронный просмотр задач / загрузка

Просматривайте отправленные задачи генерации видео и загружайте ссылки на видео в консоли APIYI — запись для поиска вне API.

Почему официальный релей Sora 2 от APIYI?

Прямая замена официального канала OpenAI, оптимизированная для производственных сценариев по критериям стабильности, сложности интеграции и затрат:

Прямое официальное подключение · 99,99% времени безотказной работы

Прозрачная передача в официальный /v1/videos OpenAI — без промежуточной обработки, без риска обхода протокола. Поведение запросов и ответов в точности совпадает с upstream. Не нужно управлять уровнями аккаунта OpenAI или рисковать из-за колебаний системы контроля.

Неограниченные параллельные запросы · Масштаб для продакшена

Линейно масштабируйте пакетные съемки, рекламные пайплайны и высокообъемное производство ассетов — без верхних ограничений по уровню аккаунта. Квота по умолчанию уже готова для продакшена; свяжитесь с нами для индивидуальных пулов ресурсов.

Та же посекундная тарификация + бонусы за пополнение

Идентичные посекундные ставки, как у официального канала OpenAI, в сочетании с бонусами за пополнение для дополнительной экономии. Неудачные задачи не тарифицируются.

Глобальный доступ без лишних сложностей

Не требуется зарубежный сервер или прокси — подключайтесь к api.apiyi.com напрямую из дата-центров материкового Китая, домашних сетей или зарубежных узлов. Полностью обходите настройку трансграничного доступа OpenAI.

Совместимо с OpenAI · Без изменений кода

Путь эндпоинта /v1/videos полностью совпадает с OpenAI. Направьте официальный OpenAI SDK на APIYI’s base_url и вызывайте как есть — имена параметров и полей совпадают один к одному.

Профессиональная поддержка · Онбординг для enterprise

Наша команда обладает глубокими знаниями в генерации видео: prompt engineering, выбор разрешения, пакетное производство и постобработка. Полная техническая поддержка от PoC до продакшена для корпоративных клиентов.

Ключевые возможности

Синхронизированные аудио и видео

Sora 2 нативно выводит видео с синхронизированными аудиодорожками (фоновый звук, диалоги, музыка) — не требуется отдельная постобработка аудио.

Многоуровневые разрешения

sora-2 поддерживает 720p (720x1280 / 1280x720); sora-2-pro добавляет уровни 1024p и 1080p вплоть до 1920x1080.

Гибкая длительность 4 / 8 / 12 секунд

Посекундная тарификация означает, что вы платите ровно за то, что создаете. 8 секунд — самый распространенный уровень, он балансирует визуальную непрерывность и стоимость.

Точное следование инструкциям

Sora 2 лидирует в своем классе по движению камеры, физике объектов и точности передачи выражений персонажей — ближе к вашему замыслу в prompt, чем конкуренты.

Изображение-в-видео (input_reference)

Загрузите одно изображение как начальный кадр, чтобы анимировать статичные изображения. См. Изображение-в-видео.

Асинхронная модель задач

Отправка сразу возвращает video_id. Отслеживайте статус отдельно и скачивайте итоговое видео — идеально для пакетной обработки и сценариев возобновления после сбоя.

Прямая замена OpenAI SDK

base_url=https://api.apiyi.com/v1 работает как прямая замена официальному OpenAI SDK.

Сбои бесплатны

В асинхронном режиме неудачные генерации, отклонения по правилам контента и ошибки нехватки capacity не тарифицируются.

Тарификация

Тарифицируется по длительности видео в секундах, аналогично официальным тарифам OpenAI. sora-2-pro имеет три уровня разрешения, каждый с отдельной тарификацией за секунду.

`sora-2` (Стандарт)

Разрешение	Ставка	4 с	8 с	12 с
`720x1280` / `1280x720`	$0.10/sec	$0.40	$0.80	$1.20

`sora-2-pro` (Pro)

Разрешение	Ставка	4 с	8 с	12 с
`720x1280` / `1280x720`	$0.30/sec	$1.20	$2.40	$3.60
`1024x1792` / `1792x1024`	$0.50/sec	$2.00	$4.00	$6.00
`1080x1920` / `1920x1080`	$0.70/sec	$2.80	$5.60	$8.40

Примечания по тарификации:

Взимается за фактически сгенерированные секунды (seconds × ставка), независимо от длины prompt или от того, указан ли input_reference
В асинхронном режиме неудачные генерации / отклонения по content policy / ошибки capacity не тарифицируются
Запросы должны использовать режим тарификации по использованию в вашей консоли APIYI (переключатель находится в настройках API Key); группы тарификации за запрос не могут направлять трафик в канал официального релея
Уровни бонусов за пополнение перечислены в Акциях пополнения

Настройка группы

Sora 2 официальный релей маршрутизируется через выделенную группу Sora2Official (1x). Должны выполняться два условия, чтобы token мог попасть в канал:

Режим тарификации: выберите приоритет по факту использования (pay-as-you-go) — billing tokens с тарификацией за запрос не могут маршрутизироваться к официальному релею
Группа: должна включать Sora2Official

Интерфейс создания token: режим тарификации установлен на приоритет по факту использования, в раскрывающемся списке групп показан Sora2Official (1x), стабильный канал посекундной тарификации официального релея OpenAI — Token creation: pick Usage-Based Priority for the billing mode and select Sora2Official under groups to call sora-2 / sora-2-pro

Две рекомендуемые конфигурации — выберите ту, которая лучше подходит для ваших требований к изоляции:

Настройка	Когда использовать	Как
A. Один token, для разных задач	Тот же token также вызывает другие модели (GPT / Claude / изображения / …)	Оставьте вашу обычную `Default` (или другую) в качестве основной группы, задайте `Sora2Official` как резервную — запросы, не относящиеся к Sora, остаются в основной группе, а вызовы `sora-2` / `sora-2-pro` автоматически маршрутизируются в `Sora2Official`
B. Выделенный token	Видеонагрузки держатся отдельно, нужны изолированные управление тарификацией и квотой	Создайте новый token, выбрав только группу `Sora2Official`, и используйте его исключительно для Sora 2

Рекомендуем B (выделенный token) для production-видеонагрузок: более понятная тарификация, проще управление квотой и оповещениями. A подходит для solo dev или редкого использования.

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

Dimension	sora-2	sora-2-pro
ID модели	`sora-2`	`sora-2-pro`
Текущий snapshot	`sora-2-2025-12-08`	Synced with alias
Устаревший snapshot	`sora-2-2025-10-06`	—
Поддерживаемые разрешения	`720x1280` / `1280x720`	`720x1280` / `1280x720` / `1024x1792` / `1792x1024` / `1080x1920` / `1920x1080`
Поддерживаемая длительность (секунды)	`4` / `8` / `12`	`4` / `8` / `12`
Аудиодорожка	✅ Синхронизировано	✅ Синхронизировано
Изображение-в-видео (input_reference)	✅	✅
Типичное время генерации	3–5 минут	5–10 минут
Срок хранения видео	1 день	1 день
Поля ответа	`id` / `status` / `progress`; загрузка через `/v1/videos/{id}/content`	То же самое

Эндпоинты API

Эндпоинт	Метод	Назначение	Content-Type
`/v1/videos`	POST	Отправить задачу на генерацию видео (text-to-video и image-to-video)	`application/json` or `multipart/form-data`
`/v1/videos/{video_id}`	GET	Опросить статус и прогресс задачи	—
`/v1/videos/{video_id}/content`	GET	Скачать сгенерированный видеофайл	—

Варианты домена: api.apiyi.com — основной эндпоинт. vip.apiyi.com / b.apiyi.com — эквивалентные резервные шлюзы с идентичным поведением.

Ключевые параметры

`seconds` (Длительность видео)

Только три строковых значения enum (не числа):

Значение	Значение	Сценарий использования
`"4"`	4 секунды (по умолчанию)	Короткие демо, одиночные кадры, быстрая итерация промптов
`"8"`	8 секунд	Стандартное короткое видео, клипы для соцсетей
`"12"`	12 секунд	Длинные планы, непрерывное действие, сюжетные последовательности

seconds должен передаваться как строка "4" / "8" / "12". Передача целого числа 4 или других значений, таких как "10" / "15", возвращает 400.

`size` (Выходное разрешение)

Поддерживаемые уровни различаются между sora-2 и sora-2-pro:

Уровень	Пиксели	sora-2	sora-2-pro
720p Portrait	`720x1280`	✅	✅ ($0.30/sec)
720p Landscape	`1280x720`	✅	✅ ($0.30/sec)
1024p Portrait	`1024x1792`	❌	✅ ($0.50/sec)
1024p Landscape	`1792x1024`	❌	✅ ($0.50/sec)
1080p Portrait	`1080x1920`	❌	✅ ($0.70/sec)
1080p Landscape	`1920x1080`	❌	✅ ($0.70/sec)

Передача размеров 1024p / 1080p в sora-2 возвращает 400
Фактическое вертикальное число пикселей при рендеринге видео sora-2 в 720p — 704 (а не 720) — это фактическое поведение upstream у OpenAI и не влияет на отображение
Для image-to-video размеры изображения input_reference должны точно совпадать с size, иначе вы получите Inpaint image must match the requested width and height

Лучшие практики

Выберите модель, которая соответствует вашим задачам

При ограниченном бюджете → sora-2 (только 720p, $0.10/sec, $0.40 за 4-секундный фрагмент)
Нужны 1080p Full HD / максимально точное следование инструкциям → sora-2-pro (до $0.70/sec, поддерживает 1920x1080)
Внутренние демо / первые итерации → начните с sora-2 на 4 секунды

Проверьте на 4 секундах, прежде чем увеличивать длительность

Сначала запускайте каждый новый prompt на seconds: "4", чтобы проверить направление камеры, стиль и общую композицию (~3 minutes, $0.40). Увеличивайте до 8 / 12 секунд только после того, как внешний вид будет зафиксирован.

Сначала переключитесь на тарификацию по использованию

В консоли APIYI установите для вашего API Key тарификацию по использованию и группу Sora2 официальный релей (Sora2 Официальный). Группы с тарификацией за каждый запрос не могут направлять запросы в канал официального релея.

Используйте асинхронный polling, а не синхронные ожидания

Канал official relay работает только в async-режиме: выполните POST для отправки и получите video_id, опрашивайте /v1/videos/{id} каждые 10–30 секунд, пока status: "completed", затем скачайте из /v1/videos/{id}/content.

Установите таймаут клиента на 30+ секунд

Сам POST лишь ставит задачу в очередь и не блокирует генерацию. При загрузке multipart input_reference большие изображения увеличивают время соединения — начните с таймаута 30 секунд.

Скачивайте видео немедленно

Видео хранятся на серверах OpenAI только 1 день; после этого, /content возвращает 404. В production-процессах нужно сразу сохранять их в собственные OSS / CDN, как только status: "completed".

Сопоставьте разрешение перед загрузкой image-to-video

При загрузке input_reference предварительно обрежьте изображение с помощью ffmpeg / Pillow до точного целевого size (например, 1280x720), чтобы избежать ошибок 400.

Коды ошибок и повторные попытки

Статус	Значение	Рекомендуемое действие
`400`	Неверные параметры (seconds не 4/8/12, size не поддерживается, dimensions input_reference не совпадают)	Проверьте параметры; предварительно обрежьте reference images до целевого разрешения
`401`	Неверный token	Проверьте ваш Bearer Token и настройку группы (должно быть `Sora2官转`)
`403`	Отклонение по content policy / неверный режим тарификации	Скорректируйте prompt; убедитесь, что API Key использует тарификацию по использованию
`429`	Лимит запросов / недостаточный баланс	Экспоненциальная задержка; доступно сразу после пополнения
`5xx`	Ошибка шлюза / вышестоящего сервиса	Повторите асинхронную задачу 1–2 раза (без списания)
Task `failed`	Генерация не удалась (чаще всего из-за content policy или ограничений upstream)	Скорректируйте prompt и повторите попытку; неудачная задача не тарифицируется

Рекомендуемая конфигурация клиента:

Таймаут отправки POST: 30 секунд (дольше для multipart uploads)
Интервал опроса GET: 10–30 секунд, максимальное ожидание 15 минут (Pro 1080p 12 seconds может занять 8–10 минут)
Повторные попытки с экспоненциальной задержкой при 5xx и задачах failed (рекомендуем 2 повторные попытки)
Записывайте заголовок ответа x-request-id для отладки

Часто задаваемые вопросы

Официальный релей vs интерфейс обратной разработки — в чем разница, и доступен ли еще интерфейс обратной разработки?

Официальный релей (эта страница): Прямое перенаправление на /v1/videos OpenAI, с полями request/response, совпадающими с исходным сервисом. Тарификация по секундам, доступность 99.99%, требуется группа с тарификацией по использованию.Интерфейс обратной разработки: Интерфейс Sora 2 обратной разработки, с тарификацией за запрос и более дешевый, но подлежит контролю рисков OpenAI. По состоянию на корректировку политики OpenAI в январе 2026 года бесплатные аккаунты были отключены, и APIYI теперь предлагает только канал официального релея. По особым потребностям обратитесь в отдел продаж.

Почему мне нужно перейти на тарификацию по использованию?

Канал официального релея рассчитывается по фактическим секундам OpenAI, что является другим измерением тарификации, чем оплата за запрос. В консоли APIYI переключите свой API Key на тарификацию по использованию + группу Sora2官转 чтобы получить доступ к этому маршруту — группы с тарификацией за запрос получат 403.

Почему только async? Есть ли вариант синхронной потоковой передачи?

Официальный /v1/videos эндпоинт сам по себе асинхронный и основан на задачах — здесь нет потоковой передачи SSE или WebSocket. Генерация клипа длительностью 4 секунды обычно занимает 3–5 минут; 12 секунд могут занять 8–10 минут. Синхронное ожидание слишком долго держало бы HTTP-соединения и стало бы ненадежным. Всегда используйте поток POST → опрос → загрузка.

Какие значения seconds поддерживаются? Почему я не могу передать 10 / 15?

OpenAI официально предоставляет только "4" / "8" / "12" в виде строковых значений enum. Значения 10 / 15 секунд были неофициальными длительностями из старого канала обратной разработки и не поддерживаются официальным релеем. Если ваш код передает "10", измените его на "8" или "12".

Новая ли ставка \$0.70/sec для sora-2-pro 1080p?

Да. OpenAI недавно расширил sora-2-pro, чтобы включить 1080x1920 / 1920x1080 Full HD по цене $0.70/sec. Ранее существовавшие уровни 720p ($0.30) и 1024p ($0.50) не изменились. Наша таблица цен выше отражает последние официальные ставки.

Как долго хранятся видео?

Видео хранятся на серверах OpenAI только 1 день. После истечения срока /v1/videos/{id}/content возвращает 404 / 410. В production-сценариях нужно сразу после status: "completed" скачать и сохранить их в собственный OSS / CDN.

Тарифицируются ли неудачные генерации?

Нет. Задачи, которые в итоге становятся failed, отклонения по политике контента, ошибки емкости и ошибки параметров не тарифицируются. Только задачи, которые фактически завершаются (status: "completed") и создают видеофайл, тарифицируются по ставке seconds.

Можно ли напрямую использовать официальный OpenAI SDK?

Да. OpenAI Python SDK 1.50+ поддерживает пространство имен videos. Укажите base_url на https://api.apiyi.com/v1:

from openai import OpenAI

client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
video = client.videos.create(
    model="sora-2",
    prompt="A golden retriever running on the beach at sunset",
    seconds="8",
    size="1280x720"
)
print(video.id, video.status)

Принимает ли input_reference base64?

Нет. input_reference — это поле загрузки файла multipart/form-data (принимает image/jpeg / image/png / image/webp) и требует multipart-запрос. Если ваше изображение в base64, сначала декодируйте его и запишите во временный файл. См. Image-to-Video.

Можно ли отключить аудиодорожку?

Пока нет. Sora 2 / Pro по умолчанию выводит синхронизированный звук (фоновый шум, диалоги, музыка), и OpenAI не предоставляет параметр для его отключения. Для вывода без звука удалите аудиодорожку с помощью ffmpeg -an после загрузки.

Можно ли отменить выполняющуюся задачу?

Нет. Официальный /v1/videos эндпоинт не предоставляет операцию отмены — после отправки задача выполняется до завершения. Сначала проверьте prompt в seconds: "4", чтобы не тратить впустую длительные прогоны.

Каковы лимиты запросов?

Они зависят от лимитов уровня аккаунта OpenAI upstream, но, поскольку они объединяются через шлюз APIYI, для типичного использования явного узкого места нет. Для enterprise-пакетных задач (>10 параллельных запросов, >100 клипов в день) следует обратиться в отдел продаж за выделенным пулом ресурсов.

Можно ли запускать несколько задач параллельно?

Да. Каждый POST /v1/videos возвращает независимый video_id. Отправляйте и опрашивайте параллельно; управляйте списком video_id в очереди задач, чтобы избежать шторма опросов.

Связанные документы

Песочница Text-to-Video — интерактивный отладчик POST /v1/videos (JSON) с 5 языковыми примерами
Песочница Image-to-Video — POST /v1/videos (multipart) + пошаговое руководство input_reference
Акции на пополнение — бонусные уровни и применимые каналы
Руководство по API — общие рекомендации по запросам, тайм-ауту и повторным попыткам
Официальная страница модели OpenAI: platform.openai.com/docs/models/sora-2
Официальная справка по API OpenAI: platform.openai.com/docs/api-reference/videos/create

Sora 2 в APIYI предоставляется через авторизованный пул аккаунтов уровня Plus для стабильного сервиса официального релея. Поля ответа, коды ошибок и размеры тарификации полностью совпадают с OpenAI для совместимости без изменений с существующим кодом. Для любой обратной связи откройте тикет из вашей консоли.

​Обзор

API преобразования текста в видео

API изображения в видео

Визуальное тестирование API

Асинхронный просмотр задач / загрузка

​Почему официальный релей Sora 2 от APIYI?

Прямое официальное подключение · 99,99% времени безотказной работы

Неограниченные параллельные запросы · Масштаб для продакшена

Та же посекундная тарификация + бонусы за пополнение

Глобальный доступ без лишних сложностей

Совместимо с OpenAI · Без изменений кода

Профессиональная поддержка · Онбординг для enterprise

​Ключевые возможности

Синхронизированные аудио и видео

Многоуровневые разрешения

Гибкая длительность 4 / 8 / 12 секунд

Точное следование инструкциям

Изображение-в-видео (input_reference)

Асинхронная модель задач

Прямая замена OpenAI SDK

Сбои бесплатны

​Тарификация

​sora-2 (Стандарт)

​sora-2-pro (Pro)

​Настройка группы

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

​Эндпоинты API

​Ключевые параметры

​seconds (Длительность видео)

​size (Выходное разрешение)

​Лучшие практики

​Коды ошибок и повторные попытки

​Часто задаваемые вопросы

​Связанные документы

Обзор

Почему официальный релей Sora 2 от APIYI?

Ключевые возможности

Тарификация

`sora-2` (Стандарт)

`sora-2-pro` (Pro)

Настройка группы

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

Эндпоинты API

Ключевые параметры

`seconds` (Длительность видео)

`size` (Выходное разрешение)

Лучшие практики

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанные документы