Sora 2 Pro API — это высококачественный вариант OpenAI для генерации видео с синхронизированным звуком и выводом в высоком разрешении. Разработка на его основе требует большего, чем просто работающий промпт. Также необходимо обрабатывать асинхронную задачу, оценивать стоимость повторных рендеров, учитывать ограничения контента и подтверждать, что выбранная вами платформа доступа в настоящее время включает sora-2-pro.
Приведённые ниже сведения о модели и цены взяты из документации OpenAI. В разделе OdiRouter используется актуальная общедоступная документация OdiRouter и объясняется, как запрашивать аутентифицированный каталог. Сам по себе URL, похожий на URL модели, не доказывает доступность модели.
Sora 2 Спецификации Pro API
Пункт | Официальная информация |
|---|---|
Идентификатор модели |
|
Снимок по умолчанию |
|
Входные модальности | Текст и изображение |
Выходные модальности | Видео и аудио |
Поддерживаемое семейство эндпоинтов |
|
Форматы высокого разрешения |
|
Задокументированная максимальная длительность генерации | До 20 секунд |
Модель обработки | Создайте задачу, получите её статус, затем скачайте контент |
OpenAI позиционирует Sora 2 Pro как более продвинутый вариант Sora 2. Он стоит дороже и рендерится дольше, чем sora-2, обеспечивая взамен более качественный и стабильный результат. OpenAI указывает высококачественные кинематографические видеоматериалы и маркетинговые активы как подходящие сферы применения модели Pro.
Videos API работает асинхронно.
Первый ответ API не содержит готового MP4. Он запускает задачу рендеринга и возвращает идентификатор, который должно отслеживать ваше приложение.
Отправьте запрос на создание в
POST /v1/videos.Сохраните возвращённые идентификатор видео и статус.
Опрашивайте
GET /v1/videos/{video_id}или зарегистрируйте вебхук.Обрабатывайте состояния
queued,in_progress,completedиfailed.После завершения скачайте файл из
GET /v1/videos/{video_id}/content.
Этот запрос соответствует документированному формату multipart в OpenAI. Храните ключ API в серверной переменной окружения.
curl -X POST "https://api.openai.com/v1/videos" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F 'model=sora-2-pro' \
-F 'size=1920x1080' \
-F 'seconds=8' \
-F 'prompt=A slow tracking shot of rain crossing a quiet glass rooftop at blue hour.'Успешный запрос на создание возвращает идентификатор и статус, например queued или in_progress. OpenAI сообщает, что рендеринг может занять несколько минут. На время ожидания влияют разрешение, длительность и нагрузка на модель. Продукт для пользователей должен показывать ход выполнения и выполнять опрос с разумным интервалом, увеличивая его при повторных попытках.
OpenAI также документирует события вебхуков video.completed и video.failed. Веб-хуки сокращают количество повторных запросов состояния, но не устраняют необходимость в проверке подписей, идемпотентной обработке или восстановлении в случае пропуска события.
Сколько стоит рендеринг по официальным расценкам
OpenAI устанавливает цены для Sora 2 Pro в зависимости от длительности и разрешения. Это были официальные расценки на дату проведения исследования:
Ориентация и разрешение | Официальная цена в секунду | Пример 8 (секунда) | Пример 20 (секунда) |
|---|---|---|---|
Портретная ориентация | $0.30 | $2.40 | $6.00 |
Портретная ориентация | $0.50 | $4.00 | $10.00 |
Портретная | $0.70 | $5.60 | $14.00 |
Итоговые значения рассчитываются как количество секунд, умноженное на опубликованную посекундную ставку. Они не включают неудачные попытки, повторные попытки, хранение, передачу данных, редактирование и сборы, специфичные для поставщика. Поскольку цены могут меняться, производственные системы должны получать актуальные тарифы, а не считать эту таблицу неизменной константой.
Количество итераций часто является более значимой переменной бюджета. Пять кандидатов в формате 1080p длительностью 8 секунд каждый стоят 5 x 8 x $0.70 = $28.00 по опубликованному тарифу генерации, без учёта повторных попыток и постобработки. Обычно дешевле протестировать движение и композицию в меньшем формате, а затем отрендерить выбранную версию в полном разрешении.
Референсные изображения, промпты и скачанные файлы
Sora 2 Pro принимает текстовые и графические входные данные. В руководстве OpenAI изображение input_reference становится первым кадром и должно соответствовать целевому разрешению. JPEG, PNG и WebP — поддерживаемые форматы референсов.
Полезный промпт для видео конкретно описывает объект, действие, камеру, окружение, освещение и тайминг. Сохраняйте версию промпта вместе с идентификатором видео. Эта небольшая часть учёта значительно упрощает последующие сравнения и повторные запуски.
После завершения эндпоинт контента может предоставить видео, миниатюру или спрайт-лист. OpenAI сообщает, что сгенерированные им URL-адреса для скачивания действительны не более одного часа. Если утверждённый файл нужно хранить дольше, скопируйте его в контролируемое вами хранилище сразу после завершения задачи.
Ограничения могут отклонить запрос, который в остальном является допустимым
В текущем руководстве по видео OpenAI указано, что промпты и входные данные должны подходить для аудитории младше 18. Сервис отклоняет защищённых авторским правом персонажей и защищённую авторским правом музыку. Согласно задокументированным правилам по умолчанию, он также блокирует генерацию реальных людей, включая публичных персон. Загрузка персонажей с человеческими чертами по умолчанию блокируется, а входные изображения, содержащие человеческие лица, в настоящее время отклоняются.
Эти правила — лишь одна из составляющих безопасности производства. Командам по-прежнему необходимы проверки согласия, анализ прав на материалы, модерация, журналы аудита и чёткий порядок обработки отклонённых заданий. Перед запуском перепроверьте официальное руководство, так как ограничения могут измениться.
Перед написанием интеграции проверьте доступность OdiRouter.
На общедоступных страницах OdiRouter описываются не только модели ИИ 200, но и сравнение цен, а также доступ через одну учетную запись. В ходе этого исследования в общедоступной карте сайта моделей и указателе документации OdiRouter не было указано sora-2-pro. Общий ответ от /models/sora-2-pro не содержал названия конкретной модели, цены или сведений об эндпоинте, поэтому он не является надёжным подтверждением доступности.
OdiRouter документирует аутентифицированный каталог для этой точной проверки:
curl --location \
"https://api.odirouter.ai/v1/models/catalog?keyword=sora-2-pro&page=1&page_size=20" \
--header "Authorization: Bearer $ODIROUTER_API_KEY"Найдите точный поддерживаемый идентификатор модели в возвращенном массиве data, затем изучите документацию по текущему поставщику, режимам работы, функциям и конечным точкам. Каталог ограничен текущим API-ключом, что делает его более надежным источником, чем старая запись или предполагаемый маршрут.
Если точная запись sora-2-pro отсутствует, не придумывайте эндпоинт OdiRouter на основе названия модели. Используйте OdiRouter models catalog и pricing page для проверки видеомоделей, которые перечислены сейчас. Другая модель может подойти для аналогичного сценария использования, но её входные данные, форматы вывода, цена и качество требуют отдельной оценки.
Как OdiRouter работает с опубликованными мультимодальными эндпоинтами
Для мультимодальных моделей, которые публикует OdiRouter, документированный базовый URL — https://api.odirouter.ai/model. Создание задачи выполняется по следующей схеме:
POST {BASE_URL}/v1/queue/{endpoint}Ответ на создание включает request_id, status_url, response_url и cancel_url. Руководство OdiRouter по опросу статуса проводит важное различие: COMPLETED — это конечное состояние, но оно не всегда означает успех. Клиент также должен проверить поле error. Результаты с медиафайлами появляются в output[].content[], а OdiRouter сообщает, что текущие ссылки на результаты обычно остаются действительными в течение семи дней.
Используйте этот шаблон очереди только с эндпоинтом, опубликованным OdiRouter. Перед отправкой запроса проверьте model-list documentation и актуальную страницу модели.
Краткий контрольный список для оценки
Прежде чем привязывать рабочий процесс продукта к API Sora 2 Pro, подтвердите следующее:
Учётная запись поставщика или текущий каталог предоставляет точный идентификатор модели
sora-2-pro.Необходимые разрешение и длительность доступны для этой учётной записи.
Текущая посекундная ставка и предполагаемое число итераций укладываются в бюджет.
Приложение обрабатывает асинхронные статусы, сбои, повторные попытки и события вебхуков.
Промпты и референсные изображения соответствуют последним ограничениям.
Готовые медиафайлы переносятся в долговременное хранилище до истечения срока действия временных ссылок.
Ключи API остаются на сервере и могут быть ротированы без изменения клиентского кода.
Журналы сохраняют идентификаторы запросов и статусы без секретов и избыточного пользовательского контента.
Для реализации OdiRouter начните с quick-start guide, запросите аутентифицированный каталог и сравните доступные в настоящий момент варианты видеомоделей, прежде чем писать код, специфичный для модели.