curl-X POST 'https://pollo.ai/api/platform/v1/generation/openai/sora-2/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "duration": 4, "aspectRatio": "16:9" }}'
При желании укажите webhookUrl, чтобы получать обратный вызов в случае успешного или неудачного выполнения задачи.
Необязательное поле запроса
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","duration":4,"aspectRatio":"16:9"},"webhookUrl":"https://example.com/webhooks/pollo"}
Схема
Поля ввода для выбранной конечной точки и режима.
Поле
Тип
Необходимый
Описание
prompt
string
Да
Text prompt describing the content to generate.
duration
number
Нет
The duration of the generated video, in seconds.
aspectRatio
string
Нет
Output aspect ratio, as width:height (e.g. 16:9).
Ошибки
Типичные коды ответов общедоступных API.
400
Недопустимые входные данные или ограничения модели.
Sora 2 генерирует видео с синхронизированным аудио, согласуя диалоги, шаги, фоновую атмосферу и события в кадре, а также поддерживает движение с учётом веса, импульса и взаимодействий.
С Sora 2 в Pollo API ты можешь интегрировать генерацию видео из текста и изображения от OpenAI в свои приложения, с HD-клипами длительностью от 4 до 20 секунд.
Ключевые возможности Sora 2 API
Синхронизированное аудио
Генерируй диалоги, звуковые эффекты и фоновую атмосферу вместе с видео, синхронизируя аудиосигналы с речью, движением и событиями в кадре.
Физически правдоподобное движение
Объекты реагируют на силу, гравитацию и контакт так же, как в реальном мире, поэтому наливание, отскоки и столкновения выглядят правдоподобно, а не как зависание или скольжение.
Согласованность между несколькими планами
Один prompt может охватывать несколько планов, при этом персонажи, окружение и освещение остаются стабильными, сохраняя целостность коротких повествовательных последовательностей от склейки к склейке.
Увеличенная длительность клипа
Поддерживается длительность видео до 20 секунд для диалогов, демонстраций, действий и коротких повествовательных сцен, которым нужно больше времени на развитие.
Управление текстом и изображением
Принимай текстовые prompt’ы и исходные изображения для генерации видео из текста и изображения, поддерживая как сценарии на основе описания, так и с опорой на изображение.
Понимание prompt’ов
Интерпретируй подробные инструкции по порядку действий, таймингу, диалогам, движению камеры и развитию сцены в рамках одной генерации.
Сценарии использования Sora 2 API
Генерация разговорных сцен: Создавай короткие диалоги, где персонажи говорят, а движение губ, тайминг и интонация соответствуют сгенерированной аудиодорожке речи.
Объясняющие ролики по физике: Показывай, как жидкости наливаются, блоки падают или пружины разжимаются, с движением, учитывающим гравитацию, силу и контакт — для обучения и демонстраций.
Короткие повествовательные последовательности: Генерируй многоплановые сюжетные сцены, сохраняя персонажа, окружение и визуальную непрерывность между склейками.
Демо с акцентом на звук: Создавай видео о продукте или процессе с диалогами, звуковыми эффектами и атмосферой, синхронизированными с действиями в кадре.
Анимация референс-кадров: Превращай загруженное изображение в движущийся план, расширяя один кадр до короткой сцены со звуком.
Инструменты интерактивных историй: Генерируй видеосцены из prompt’ов, написанных пользователем, для приложений интерактивного сторителлинга, персонажей и повествования.
Черновики рекламных концепций: Создавай ранние рекламные концепты со сценарными диалогами, визуальным действием и синхронизированной атмосферой для планирования кампаний.
Вертикальный контент для соцсетей: Генерируй клипы 9:16 с синхронизированным аудио для коротких лент, stories и мобильных видеосценариев.
Как использовать Sora 2 API
Получи API-ключ: Создай аккаунт Pollo API и сгенерируй API-ключ в панели разработчика.
Выбери модель: Отправляй запросы на endpoint Sora 2 по адресу /generation/sora/sora-2.
Добавь входные данные: Укажи prompt для генерации видео из текста или URL image для генерации видео из изображения, затем задай length (4, 8, 12, 16 или 20) и aspectRatio (16:9 или 9:16).
Сгенерируй и получи результат: Отправь задачу, опрашивай возвращённый статус задачи и скачай готовое видео с аудио после успешной обработки.
Лучшие практики prompt’ов для Sora 2 API
Рассматривай prompt как список планов со звуком. Описывай действие по порядку, указывай произносимые реплики и задавай диалоги, атмосферу, музыку или звуковые эффекты, чтобы направить синхронизированный результат видео и аудио.
Простая формула prompt’а
Сцена и субъект + упорядоченные действия с физическими деталями + диалог или звуковые подсказки + камера и смена планов + окружение и освещение
На что стоит обратить внимание
Пропиши аудио: Указывай диалоги, звуковые эффекты или атмосферу напрямую, чтобы направить генерацию аудиодорожки.
Выстрой последовательность действий: Опиши, что происходит сначала, потом и в конце, чтобы задать тайминг и развитие многоплановых сцен.
Зафиксируй физику: Уточняй действия с силой и контактом, например опрокидывание объекта или разбрызгивание жидкости, чтобы получить нужное движение.
Удерживай субъект: Повторяй важные характеристики персонажа или объекта, чтобы сохранить визуальную согласованность между планами.
Соотнеси длительность с историей: Выбирай большую длительность для диалогов, многошаговых действий или развёрнутых сцен и меньшую — для одного действия.
Выбери формат кадра: Перед генерацией задай 16:9 для горизонтального видео или 9:16 для вертикальных форматов контента.
Примеры prompt’ов
Синхронизированный обмен репликами
"Два коллеги встречаются у офисной кофемашины. Один говорит: 'Ты уже допил?' второй смеётся и отвечает: 'Еле-еле.' Чашки звякают, кофемашина гудит. Средний план на двоих, тёплый дневной свет, затем склейка на крупную реакцию."
Демонстрация физики
"Стакан воды стоит на лабораторном столе. Рука бросает шипучую таблетку; она громко шипит, пузырьки поднимаются и немного переливаются на стол. Статичный крупный план, яркий равномерный свет, чёткая реалистичная детализация бурлящей жидкости."
Многоплановая мини-история
"Ребёнок запускает бумажный кораблик в дождевой сток; общий план, как он плывёт. Склейка на низкий крупный план, когда он переваливается через маленький водопад, вода бурлит. Склейка на разочарованное лицо ребёнка. Пасмурный свет, всё время слышен дождь."
Кухонный клип с шипением
"Шеф кладёт стейк на горячую сковороду; он резко шипит, поднимается пар, и вытапливается жир. Сверху ложкой поливают масло, оно пузырится. Плотный верхний план, тёплый кухонный свет, затем медленный отъезд камеры, открывающий сервированное блюдо."
Sora 2 vs Veo 3.1 vs Kling 2.6
Возможность
Sora 2
Veo 3.1
Kling 2.6
Синхронизированное аудио
✅ Диалоги и эффекты синхронно с картинкой
✅ Нативная поддержка аудио
❌ Только видео
Реалистичность физики
✅ Сильная причинно-следственная динамика
✅ Приземлённое движение
✅ Плавно, с меньшим фокусом на физике
Согласованность между несколькими планами
✅ Сохраняется между склейками
✅
✅ Режиссируемые короткие планы
Длительность клипа
До 20 секунд
Короткие клипы
Короткие клипы
Типы входных данных
Текст и изображение
Текст, изображение, референс
Текст и изображение
Рекомендуется для
Разговорных сцен, звуково-ориентированных и физических сцен
Кинематографичных кадров с богатым звуком
Движения персонажей и стилизованных клипов
Почему стоит выбрать Sora 2 API?
Sora 2 сочетает синхронизированное аудио, физически правдоподобное движение и непрерывность между несколькими планами в одном рабочем процессе генерации. Эти возможности подходят для диалоговых сцен, демонстраций продуктов, коротких историй, рекламных концепций и интерактивных видеоприложений.
Pollo API даёт единый способ доступа к Sora 2 вместе с другими видео- и image-моделями, упрощая интеграцию, управление задачами, тестирование моделей и развёртывание.
FAQ по Sora 2 API
Что такое Sora 2?
Sora 2 — это модель генерации видео от OpenAI, которая создаёт HD-клипы с синхронизированным аудио, реалистичной физикой и согласованностью между несколькими планами, поддерживая генерацию как из текста, так и из изображения.
Sora 2 API генерирует аудио?
Да. Sora 2 создаёт звуковую дорожку вместе с видео, поэтому диалоги, звуковые эффекты и атмосфера синхронизируются с действиями в кадре, а не добавляются потом.
Какие длительности клипов и соотношения сторон поддерживаются?
Sora 2 генерирует клипы длительностью 4, 8, 12, 16 или 20 секунд в форматах 16:9 или 9:16, которые выбираются в каждом запросе под широкий или вертикальный формат.
Может ли Sora 2 анимировать изображение?
Да. Передай URL изображения, и Sora 2 превратит этот статичный кадр в движущийся план со звуком, однако изображения с человеческими лицами не допускаются.
Насколько хорошо Sora 2 работает с движением?
Его сильная сторона — физическая правдоподобность: наливаемые жидкости, столкновения и падающие объекты следуют причинно-следственным связям, делая демонстрации и экшен убедительными.
Зачем запускать Sora 2 через Pollo API?
Pollo API предоставляет доступ к Sora 2 вместе с другими видео- и image-моделями через единую интеграцию, с документацией API и отслеживанием статуса задач для асинхронной генерации.
