Sora 2 — модель OpenAI для генерации видео и аудио: динамических клипов по письменному описанию сцены или изображению-референсу. Она генерирует визуальную последовательность вместе с синхронизированными речью, эффектами и фоновым звуком. Стандартный вариант Sora 2 предназначен для визуальных экспериментов, разработки концепций, прототипов и чернового монтажа. Sora 2 Pro — отдельная редакция, ориентированная на большую визуальную точность и финальную обработку в более высоком разрешении.
Руководство разработчика по запросам строит полезный бриф вокруг кадрирования, объекта, действия, обстановки и света. Задайте сцене цельный визуальный стиль, затем опишите движение ясными этапами. Оригинальная продуктовая концепция может показывать небольшой механический предмет, который один раз поворачивается на верстаке, пока камера медленно приближается, с мягким светом из окна и негромким звуком мотора. Укажите, что зритель должен заметить и как заканчивается действие.
Делайте движение камеры и действие объекта в каждом кадре понятными. Сложную последовательность можно разделить на отдельные блоки кадров, каждый со своим кадрированием, действием и освещением. Сохраняйте одинаковые детали объекта и палитру, если несколько клипов должны образовать одну последовательность. Руководство подчёркивает, что короткие кадры обычно надёжнее следуют указаниям, а повторная генерация по одному запросу создаёт разные дубли.
Анонс модели описывает улучшенное физическое поведение и непрерывность между кадрами, включая реалистичный, кинематографический и аниме-стили. Это предполагаемые возможности, которые нужно направлять и проверять. Оценивайте движение, контакт объектов, пропорции и непрерывность, а не предполагайте, что правдоподобный первый кадр гарантирует связную последовательность. Если действие неясно, упростите его и задайте видимые начало и конец.
Задавайте произносимые реплики отдельно от визуального описания и последовательно обозначайте говорящих. Делайте диалог достаточно коротким, чтобы он помещался в действие и заданную длину клипа. Для анимации с двумя персонажами чередуйте краткие вопрос и ответ, а не пытайтесь вместить длинную речь в короткий кадр. Руководство предупреждает, что сложный и длинный диалог может нарушить темп и синхронизацию.
Опишите звуковую среду сцены: звук небольшого движения, атмосферу помещения или ритм окружающего эффекта. Объясните, какой звук должен совпадать с действием. Прослушайте полученную речь и эффекты вместе с изображением, проверяя распределение реплик между говорящими, формулировки и время. Синхронизированное аудио — часть сгенерированного клипа, а не отдельный текстовый ответ.
Документированные размеры вывода стандартной модели — 720×1280 в вертикальной ориентации и 1280×720 в горизонтальной. Размеры более высокого разрешения из варианта Pro не следует приписывать стандартной Sora 2. Размер и длительность — явные настройки запроса; другой размер или просьба о более длинном фильме в тексте запроса не меняют эти настройки. Справочник создания перечисляет настройки клипов длительностью 4, 8 и 12 секунд, поэтому при подготовке кадра выбирайте короткое, определённое действие. Расширенный процесс разработчика также документирует настройки клипов длительностью 16 и 20 секунд.
Изображение-референс задаёт первый кадр, а текст описывает последующие события. Разработчик поддерживает референсы JPEG, PNG и WebP и требует, чтобы изображение соответствовало целевому размеру видео. Подготовьте объект, окружение и композицию в этом начальном изображении, затем запросите конкретное движение. Это референс начального кадра, а не гарантия совпадения каждой детали на протяжении клипа.
Расширенный процесс разработчика может создавать повторно используемый ресурс персонажа из короткого видео-референса животного, маскота или объекта. Рекомендации по подготовке требуют клип MP4 продолжительностью примерно от двух до четырёх секунд, от 720p до 1080p, с соотношением сторон 16:9 или 9:16. Совпадение соотношения сторон источника и результата помогает избежать растянутого вида. Генерация может ссылаться максимум на двух персонажей.
Сохраняйте идентификатор персонажа и упоминайте его имя в запросе; передача одного идентификатора не составляет полной подготовки по руководству. Ресурсы персонажей могут сопровождать генерацию по изображению, но продолжения видео их не принимают. Разработчик по умолчанию блокирует загрузки персонажей с человеческим обликом и в документированном процессе API отклоняет изображения-референсы с человеческими лицами. Функции личных персонажей приложения Sora — отдельный продуктовый процесс.
Продолжение принимает готовое исходное видео и запрос на продолжение, используя весь исходный клип как контекст для движения, направления камеры и непрерывности сцены. Руководство описывает добавление до 20 секунд за одно продолжение. Документированный ввод продолжения — исходное видео и текст; дополнительные референсы персонажей или изображений исключены из этого режима. Опишите, как продолжается существующее действие, а не вводите несвязанную сцену без перехода.
Редактирование видео нацелено на ясное изменение существующего клипа. Точечная правка может менять цвет объекта или палитру сцены, сохраняя остальную часть кадра. Руководство разработчика рекомендует одно чётко определённое изменение за раз и отличает редактирование сгенерированного видео от загрузки произвольных материалов, для которой есть отдельное условие допуска. Сохраняйте готовый источник и определяйте точную нужную правку перед следующим редактированием.
Документированный процесс видео разработчика асинхронен: отправленное задание может находиться в очереди или выполняться, прежде чем завершиться успешно или с ошибкой. Завершённое задание выдаёт видео MP4; миниатюры и спрайтовые листы помогают предварительному просмотру и навигации. Сохраняйте связь идентификатора задания с запросом, референсами и возвращёнными ресурсами. Первоначальный ответ задания не является итоговым воспроизводимым видео.
Обычный процесс загрузки описывает срок действия URL скачивания в один час. Расширенный пакетный процесс подготавливает независимые JSON-запросы рендеринга со стабильными идентификаторами элементов, загруженными референсами и результатом, сопоставленным каждому кадру; его готовые ресурсы имеют отдельный период скачивания до 24 часов. Своевременно сохраняйте готовый клип и проверяйте фактические изображение и звук, прежде чем считать его выбранным дублем.
Документированные ограничения контента API разработчика требуют материалов, подходящих для аудитории младше 18 лет, и отклоняют защищённых авторским правом персонажей или музыку, а также генерацию реальных людей. Подготавливайте сцену и референсы соответственно. Прямой результат модели — видео с аудио, а не сгенерированные отдельные изображения, диалоговый ответ инструмента или фильм неограниченной длины. Сохраняйте точное обозначение стандартной модели и принятый исходный клип при продолжении визуальной концепции.
", "aboutText": "Sora 2 — модель OpenAI для генерации видео и аудио: динамических клипов по письменному описанию сцены или изображению-референсу. Она генерирует визуальную последовательность вместе с синхронизированными речью, эффектами и фоновым звуком. Стандартный вариант Sora 2 предназначен для визуальных экспериментов, разработки концепций, прототипов и чернового монтажа. Sora 2 Pro — отдельная редакция, ориентированная на большую визуальную точность и финальную обработку в более высоком разрешении.\n\n### Опишите кадр, который можно увидеть и услышать\n\nРуководство разработчика по запросам строит полезный бриф вокруг кадрирования, объекта, действия, обстановки и света. Задайте сцене цельный визуальный стиль, затем опишите движение ясными этапами. Оригинальная продуктовая концепция может показывать небольшой механический предмет, который один раз поворачивается на верстаке, пока камера медленно приближается, с мягким светом из окна и негромким звуком мотора. Укажите, что зритель должен заметить и как заканчивается действие.\n\nДелайте движение камеры и действие объекта в каждом кадре понятными. Сложную последовательность можно разделить на отдельные блоки кадров, каждый со своим кадрированием, действием и освещением. Сохраняйте одинаковые детали объекта и палитру, если несколько клипов должны образовать одну последовательность. Руководство подчёркивает, что короткие кадры обычно надёжнее следуют указаниям, а повторная генерация по одному запросу создаёт разные дубли.\n\nАнонс модели описывает улучшенное физическое поведение и непрерывность между кадрами, включая реалистичный, кинематографический и аниме-стили. Это предполагаемые возможности, которые нужно направлять и проверять. Оценивайте движение, контакт объектов, пропорции и непрерывность, а не предполагайте, что правдоподобный первый кадр гарантирует связную последовательность. Если действие неясно, упростите его и задайте видимые начало и конец.\n\n### Режиссируйте диалог и звук отдельно\n\nЗадавайте произносимые реплики отдельно от визуального описания и последовательно обозначайте говорящих. Делайте диалог достаточно коротким, чтобы он помещался в действие и заданную длину клипа. Для анимации с двумя персонажами чередуйте краткие вопрос и ответ, а не пытайтесь вместить длинную речь в короткий кадр. Руководство предупреждает, что сложный и длинный диалог может нарушить темп и синхронизацию.\n\nОпишите звуковую среду сцены: звук небольшого движения, атмосферу помещения или ритм окружающего эффекта. Объясните, какой звук должен совпадать с действием. Прослушайте полученную речь и эффекты вместе с изображением, проверяя распределение реплик между говорящими, формулировки и время. Синхронизированное аудио — часть сгенерированного клипа, а не отдельный текстовый ответ.\n\n### Размер, длительность и начало по изображению\n\nДокументированные размеры вывода стандартной модели — 720×1280 в вертикальной ориентации и 1280×720 в горизонтальной. Размеры более высокого разрешения из варианта Pro не следует приписывать стандартной Sora 2. Размер и длительность — явные настройки запроса; другой размер или просьба о более длинном фильме в тексте запроса не меняют эти настройки. Справочник создания перечисляет настройки клипов длительностью 4, 8 и 12 секунд, поэтому при подготовке кадра выбирайте короткое, определённое действие. Расширенный процесс разработчика также документирует настройки клипов длительностью 16 и 20 секунд.\n\nИзображение-референс задаёт первый кадр, а текст описывает последующие события. Разработчик поддерживает референсы JPEG, PNG и WebP и требует, чтобы изображение соответствовало целевому размеру видео. Подготовьте объект, окружение и композицию в этом начальном изображении, затем запросите конкретное движение. Это референс начального кадра, а не гарантия совпадения каждой детали на протяжении клипа.\n\n### Повторно используемые нечеловеческие персонажи\n\nРасширенный процесс разработчика может создавать повторно используемый ресурс персонажа из короткого видео-референса животного, маскота или объекта. Рекомендации по подготовке требуют клип MP4 продолжительностью примерно от двух до четырёх секунд, от 720p до 1080p, с соотношением сторон 16:9 или 9:16. Совпадение соотношения сторон источника и результата помогает избежать растянутого вида. Генерация может ссылаться максимум на двух персонажей.\n\nСохраняйте идентификатор персонажа и упоминайте его имя в запросе; передача одного идентификатора не составляет полной подготовки по руководству. Ресурсы персонажей могут сопровождать генерацию по изображению, но продолжения видео их не принимают. Разработчик по умолчанию блокирует загрузки персонажей с человеческим обликом и в документированном процессе API отклоняет изображения-референсы с человеческими лицами. Функции личных персонажей приложения Sora — отдельный продуктовый процесс.\n\n### Продолжите или отредактируйте завершённый клип\n\nПродолжение принимает готовое исходное видео и запрос на продолжение, используя весь исходный клип как контекст для движения, направления камеры и непрерывности сцены. Руководство описывает добавление до 20 секунд за одно продолжение. Документированный ввод продолжения — исходное видео и текст; дополнительные референсы персонажей или изображений исключены из этого режима. Опишите, как продолжается существующее действие, а не вводите несвязанную сцену без перехода.\n\nРедактирование видео нацелено на ясное изменение существующего клипа. Точечная правка может менять цвет объекта или палитру сцены, сохраняя остальную часть кадра. Руководство разработчика рекомендует одно чётко определённое изменение за раз и отличает редактирование сгенерированного видео от загрузки произвольных материалов, для которой есть отдельное условие допуска. Сохраняйте готовый источник и определяйте точную нужную правку перед следующим редактированием.\n\n### Задания рендеринга и готовое видео\n\nДокументированный процесс видео разработчика асинхронен: отправленное задание может находиться в очереди или выполняться, прежде чем завершиться успешно или с ошибкой. Завершённое задание выдаёт видео MP4; миниатюры и спрайтовые листы помогают предварительному просмотру и навигации. Сохраняйте связь идентификатора задания с запросом, референсами и возвращёнными ресурсами. Первоначальный ответ задания не является итоговым воспроизводимым видео.\n\nОбычный процесс загрузки описывает срок действия URL скачивания в один час. Расширенный пакетный процесс подготавливает независимые JSON-запросы рендеринга со стабильными идентификаторами элементов, загруженными референсами и результатом, сопоставленным каждому кадру; его готовые ресурсы имеют отдельный период скачивания до 24 часов. Своевременно сохраняйте готовый клип и проверяйте фактические изображение и звук, прежде чем считать его выбранным дублем.\n\nДокументированные ограничения контента API разработчика требуют материалов, подходящих для аудитории младше 18 лет, и отклоняют защищённых авторским правом персонажей или музыку, а также генерацию реальных людей. Подготавливайте сцену и референсы соответственно. Прямой результат модели — видео с аудио, а не сгенерированные отдельные изображения, диалоговый ответ инструмента или фильм неограниченной длины. Сохраняйте точное обозначение стандартной модели и принятый исходный клип при продолжении визуальной концепции.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5f4273aa2ac7fc928088b1ce81ac7831590650f91f5d38ef1c7d90052722e882", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "sora-2Sora 2 создаёт видео с синхронизированными диалогами, звуковыми эффектами и фоновым звуком по тексту или изображению-референсу. Стандартный вариант поддерживает визуальные эксперименты и концептуальные клипы; разработчик предоставляет отдельные процессы для повторно используемых нечеловеческих персонажей, продолжения и точечных правок видео.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Sora 2 — модель OpenAI для генерации видео и аудио: динамических клипов по письменному описанию сцены или изображению-референсу. Она генерирует визуальную последовательность вместе с синхронизированными речью, эффектами и фоновым звуком. Стандартный вариант Sora 2 предназначен для визуальных экспериментов, разработки концепций, прототипов и чернового монтажа. Sora 2 Pro — отдельная редакция, ориентированная на большую визуальную точность и финальную обработку в более высоком разрешении.
Руководство разработчика по запросам строит полезный бриф вокруг кадрирования, объекта, действия, обстановки и света. Задайте сцене цельный визуальный стиль, затем опишите движение ясными этапами. Оригинальная продуктовая концепция может показывать небольшой механический предмет, который один раз поворачивается на верстаке, пока камера медленно приближается, с мягким светом из окна и негромким звуком мотора. Укажите, что зритель должен заметить и как заканчивается действие.
Делайте движение камеры и действие объекта в каждом кадре понятными. Сложную последовательность можно разделить на отдельные блоки кадров, каждый со своим кадрированием, действием и освещением. Сохраняйте одинаковые детали объекта и палитру, если несколько клипов должны образовать одну последовательность. Руководство подчёркивает, что короткие кадры обычно надёжнее следуют указаниям, а повторная генерация по одному запросу создаёт разные дубли.
Анонс модели описывает улучшенное физическое поведение и непрерывность между кадрами, включая реалистичный, кинематографический и аниме-стили. Это предполагаемые возможности, которые нужно направлять и проверять. Оценивайте движение, контакт объектов, пропорции и непрерывность, а не предполагайте, что правдоподобный первый кадр гарантирует связную последовательность. Если действие неясно, упростите его и задайте видимые начало и конец.
Задавайте произносимые реплики отдельно от визуального описания и последовательно обозначайте говорящих. Делайте диалог достаточно коротким, чтобы он помещался в действие и заданную длину клипа. Для анимации с двумя персонажами чередуйте краткие вопрос и ответ, а не пытайтесь вместить длинную речь в короткий кадр. Руководство предупреждает, что сложный и длинный диалог может нарушить темп и синхронизацию.
Опишите звуковую среду сцены: звук небольшого движения, атмосферу помещения или ритм окружающего эффекта. Объясните, какой звук должен совпадать с действием. Прослушайте полученную речь и эффекты вместе с изображением, проверяя распределение реплик между говорящими, формулировки и время. Синхронизированное аудио — часть сгенерированного клипа, а не отдельный текстовый ответ.
Документированные размеры вывода стандартной модели — 720×1280 в вертикальной ориентации и 1280×720 в горизонтальной. Размеры более высокого разрешения из варианта Pro не следует приписывать стандартной Sora 2. Размер и длительность — явные настройки запроса; другой размер или просьба о более длинном фильме в тексте запроса не меняют эти настройки. Справочник создания перечисляет настройки клипов длительностью 4, 8 и 12 секунд, поэтому при подготовке кадра выбирайте короткое, определённое действие. Расширенный процесс разработчика также документирует настройки клипов длительностью 16 и 20 секунд.
Изображение-референс задаёт первый кадр, а текст описывает последующие события. Разработчик поддерживает референсы JPEG, PNG и WebP и требует, чтобы изображение соответствовало целевому размеру видео. Подготовьте объект, окружение и композицию в этом начальном изображении, затем запросите конкретное движение. Это референс начального кадра, а не гарантия совпадения каждой детали на протяжении клипа.
Расширенный процесс разработчика может создавать повторно используемый ресурс персонажа из короткого видео-референса животного, маскота или объекта. Рекомендации по подготовке требуют клип MP4 продолжительностью примерно от двух до четырёх секунд, от 720p до 1080p, с соотношением сторон 16:9 или 9:16. Совпадение соотношения сторон источника и результата помогает избежать растянутого вида. Генерация может ссылаться максимум на двух персонажей.
Сохраняйте идентификатор персонажа и упоминайте его имя в запросе; передача одного идентификатора не составляет полной подготовки по руководству. Ресурсы персонажей могут сопровождать генерацию по изображению, но продолжения видео их не принимают. Разработчик по умолчанию блокирует загрузки персонажей с человеческим обликом и в документированном процессе API отклоняет изображения-референсы с человеческими лицами. Функции личных персонажей приложения Sora — отдельный продуктовый процесс.
Продолжение принимает готовое исходное видео и запрос на продолжение, используя весь исходный клип как контекст для движения, направления камеры и непрерывности сцены. Руководство описывает добавление до 20 секунд за одно продолжение. Документированный ввод продолжения — исходное видео и текст; дополнительные референсы персонажей или изображений исключены из этого режима. Опишите, как продолжается существующее действие, а не вводите несвязанную сцену без перехода.
Редактирование видео нацелено на ясное изменение существующего клипа. Точечная правка может менять цвет объекта или палитру сцены, сохраняя остальную часть кадра. Руководство разработчика рекомендует одно чётко определённое изменение за раз и отличает редактирование сгенерированного видео от загрузки произвольных материалов, для которой есть отдельное условие допуска. Сохраняйте готовый источник и определяйте точную нужную правку перед следующим редактированием.
Документированный процесс видео разработчика асинхронен: отправленное задание может находиться в очереди или выполняться, прежде чем завершиться успешно или с ошибкой. Завершённое задание выдаёт видео MP4; миниатюры и спрайтовые листы помогают предварительному просмотру и навигации. Сохраняйте связь идентификатора задания с запросом, референсами и возвращёнными ресурсами. Первоначальный ответ задания не является итоговым воспроизводимым видео.
Обычный процесс загрузки описывает срок действия URL скачивания в один час. Расширенный пакетный процесс подготавливает независимые JSON-запросы рендеринга со стабильными идентификаторами элементов, загруженными референсами и результатом, сопоставленным каждому кадру; его готовые ресурсы имеют отдельный период скачивания до 24 часов. Своевременно сохраняйте готовый клип и проверяйте фактические изображение и звук, прежде чем считать его выбранным дублем.
Документированные ограничения контента API разработчика требуют материалов, подходящих для аудитории младше 18 лет, и отклоняют защищённых авторским правом персонажей или музыку, а также генерацию реальных людей. Подготавливайте сцену и референсы соответственно. Прямой результат модели — видео с аудио, а не сгенерированные отдельные изображения, диалоговый ответ инструмента или фильм неограниченной длины. Сохраняйте точное обозначение стандартной модели и принятый исходный клип при продолжении визуальной концепции.
POST /v1/chat/completionstextjson, sse| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения sora-2 | По умолчанию— |
Полеmessages | Типmessage[] | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеmessages[].role | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеmessages[].content | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюfalse |
owned_text_messages
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, messages |
Параметрmaterial_types | Контрактtext |
Параметрmessages | Контрактмассив сообщений с role и буквальным строковым content |
Параметрfile_material | КонтрактФактический материал UTF-8 можно вставить как буквальное строковое содержимое; ссылка на файл не подразумевается. |
Параметрoptional_controls | Контрактstream |
Жизненный цикл: synchronous_json_or_sse
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
| Конфигурация | Шкала ставок | Плата |
|---|---|---|
| КонфигурацияБазовые ставки за токены | Шкала ставокБазовая ставка | Плата Вход · Входные токены $0 / 1K токенов Выход · Выходные токены $0.2 / 1K токенов Вход · Чтение кэша $0 / 1K токенов Вход · Запись в кэш $0 / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":false}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nfrom pathlib import Path\nprint(Path("result.json").read_text(encoding="utf-8"))\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model="sora-2", messages=[{"role":"user","content":"hello"}], stream=False)\nimport json\nfrom pathlib import Path\n\ndata = result.to_dict(mode="json")\nPath("result.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\nprint(json.dumps(data, ensure_ascii=False, indent=2))\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":true}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.sse\nJSON или text/event-stream
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраните полный JSON или все байты SSE, заголовки ответа, возвращённые данные об использовании и все предоставленные поля результата. Конкретный тип результата для отдельной модели не заявляется.
Сохраните исходный ответ и идентичность попытки; это не подразумевает проверку новой задачи или повторную отправку.
| Поле | Тип | Значение |
|---|---|---|
Полеcomplete response JSON | Типobject | ЗначениеСохраняйте каждое возвращённое поле, не предполагая тип результата, характерный для отдельной модели. |
ПолеSSE data events | Типstream | ЗначениеСохраняйте каждое возвращённое событие и маркер завершения, не выбирая только текстовые поля. |
Ailoot Ultra sora-2
Используйте пути методов, указанные выше.
sora-2Sora 2 создаёт видео с синхронизированными диалогами, звуковыми эффектами и фоновым звуком по тексту или изображению-референсу. Стандартный вариант поддерживает визуальные эксперименты и концептуальные клипы; разработчик предоставляет отдельные процессы для повторно используемых нечеловеческих персонажей, продолжения и точечных правок видео.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Sora 2 — модель OpenAI для генерации видео и аудио: динамических клипов по письменному описанию сцены или изображению-референсу. Она генерирует визуальную последовательность вместе с синхронизированными речью, эффектами и фоновым звуком. Стандартный вариант Sora 2 предназначен для визуальных экспериментов, разработки концепций, прототипов и чернового монтажа. Sora 2 Pro — отдельная редакция, ориентированная на большую визуальную точность и финальную обработку в более высоком разрешении.
Руководство разработчика по запросам строит полезный бриф вокруг кадрирования, объекта, действия, обстановки и света. Задайте сцене цельный визуальный стиль, затем опишите движение ясными этапами. Оригинальная продуктовая концепция может показывать небольшой механический предмет, который один раз поворачивается на верстаке, пока камера медленно приближается, с мягким светом из окна и негромким звуком мотора. Укажите, что зритель должен заметить и как заканчивается действие.
Делайте движение камеры и действие объекта в каждом кадре понятными. Сложную последовательность можно разделить на отдельные блоки кадров, каждый со своим кадрированием, действием и освещением. Сохраняйте одинаковые детали объекта и палитру, если несколько клипов должны образовать одну последовательность. Руководство подчёркивает, что короткие кадры обычно надёжнее следуют указаниям, а повторная генерация по одному запросу создаёт разные дубли.
Анонс модели описывает улучшенное физическое поведение и непрерывность между кадрами, включая реалистичный, кинематографический и аниме-стили. Это предполагаемые возможности, которые нужно направлять и проверять. Оценивайте движение, контакт объектов, пропорции и непрерывность, а не предполагайте, что правдоподобный первый кадр гарантирует связную последовательность. Если действие неясно, упростите его и задайте видимые начало и конец.
Задавайте произносимые реплики отдельно от визуального описания и последовательно обозначайте говорящих. Делайте диалог достаточно коротким, чтобы он помещался в действие и заданную длину клипа. Для анимации с двумя персонажами чередуйте краткие вопрос и ответ, а не пытайтесь вместить длинную речь в короткий кадр. Руководство предупреждает, что сложный и длинный диалог может нарушить темп и синхронизацию.
Опишите звуковую среду сцены: звук небольшого движения, атмосферу помещения или ритм окружающего эффекта. Объясните, какой звук должен совпадать с действием. Прослушайте полученную речь и эффекты вместе с изображением, проверяя распределение реплик между говорящими, формулировки и время. Синхронизированное аудио — часть сгенерированного клипа, а не отдельный текстовый ответ.
Документированные размеры вывода стандартной модели — 720×1280 в вертикальной ориентации и 1280×720 в горизонтальной. Размеры более высокого разрешения из варианта Pro не следует приписывать стандартной Sora 2. Размер и длительность — явные настройки запроса; другой размер или просьба о более длинном фильме в тексте запроса не меняют эти настройки. Справочник создания перечисляет настройки клипов длительностью 4, 8 и 12 секунд, поэтому при подготовке кадра выбирайте короткое, определённое действие. Расширенный процесс разработчика также документирует настройки клипов длительностью 16 и 20 секунд.
Изображение-референс задаёт первый кадр, а текст описывает последующие события. Разработчик поддерживает референсы JPEG, PNG и WebP и требует, чтобы изображение соответствовало целевому размеру видео. Подготовьте объект, окружение и композицию в этом начальном изображении, затем запросите конкретное движение. Это референс начального кадра, а не гарантия совпадения каждой детали на протяжении клипа.
Расширенный процесс разработчика может создавать повторно используемый ресурс персонажа из короткого видео-референса животного, маскота или объекта. Рекомендации по подготовке требуют клип MP4 продолжительностью примерно от двух до четырёх секунд, от 720p до 1080p, с соотношением сторон 16:9 или 9:16. Совпадение соотношения сторон источника и результата помогает избежать растянутого вида. Генерация может ссылаться максимум на двух персонажей.
Сохраняйте идентификатор персонажа и упоминайте его имя в запросе; передача одного идентификатора не составляет полной подготовки по руководству. Ресурсы персонажей могут сопровождать генерацию по изображению, но продолжения видео их не принимают. Разработчик по умолчанию блокирует загрузки персонажей с человеческим обликом и в документированном процессе API отклоняет изображения-референсы с человеческими лицами. Функции личных персонажей приложения Sora — отдельный продуктовый процесс.
Продолжение принимает готовое исходное видео и запрос на продолжение, используя весь исходный клип как контекст для движения, направления камеры и непрерывности сцены. Руководство описывает добавление до 20 секунд за одно продолжение. Документированный ввод продолжения — исходное видео и текст; дополнительные референсы персонажей или изображений исключены из этого режима. Опишите, как продолжается существующее действие, а не вводите несвязанную сцену без перехода.
Редактирование видео нацелено на ясное изменение существующего клипа. Точечная правка может менять цвет объекта или палитру сцены, сохраняя остальную часть кадра. Руководство разработчика рекомендует одно чётко определённое изменение за раз и отличает редактирование сгенерированного видео от загрузки произвольных материалов, для которой есть отдельное условие допуска. Сохраняйте готовый источник и определяйте точную нужную правку перед следующим редактированием.
Документированный процесс видео разработчика асинхронен: отправленное задание может находиться в очереди или выполняться, прежде чем завершиться успешно или с ошибкой. Завершённое задание выдаёт видео MP4; миниатюры и спрайтовые листы помогают предварительному просмотру и навигации. Сохраняйте связь идентификатора задания с запросом, референсами и возвращёнными ресурсами. Первоначальный ответ задания не является итоговым воспроизводимым видео.
Обычный процесс загрузки описывает срок действия URL скачивания в один час. Расширенный пакетный процесс подготавливает независимые JSON-запросы рендеринга со стабильными идентификаторами элементов, загруженными референсами и результатом, сопоставленным каждому кадру; его готовые ресурсы имеют отдельный период скачивания до 24 часов. Своевременно сохраняйте готовый клип и проверяйте фактические изображение и звук, прежде чем считать его выбранным дублем.
Документированные ограничения контента API разработчика требуют материалов, подходящих для аудитории младше 18 лет, и отклоняют защищённых авторским правом персонажей или музыку, а также генерацию реальных людей. Подготавливайте сцену и референсы соответственно. Прямой результат модели — видео с аудио, а не сгенерированные отдельные изображения, диалоговый ответ инструмента или фильм неограниченной длины. Сохраняйте точное обозначение стандартной модели и принятый исходный клип при продолжении визуальной концепции.
POST /v1/messagestextjson, sse| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения sora-2 | По умолчанию— |
Полеmessages | Типmessage[] | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеmessages[].role | Типstring | ТребованиеОбязательно | Значения и ограничения user, assistant | По умолчанию— |
Полеmessages[].content | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеmax_tokens | Типinteger | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюfalse |
Текст · Текст UTF-8
строка messages[].content
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, messages, max_tokens |
Параметрoptional_controls | Контрактstream |
Параметрmaterial_types | Контрактtext |
Параметрtext_file_material | КонтрактПрочитайте фактический документ UTF-8 и поместите его текст в указанную строку входа или содержимого сообщения. |
Жизненный цикл: synchronous_or_streamed
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
| Конфигурация | Шкала ставок | Плата |
|---|---|---|
| КонфигурацияБазовые ставки за токены | Шкала ставокБазовая ставка | Плата Вход · Входные токены $0 / 1K токенов Выход · Выходные токены $0.2 / 1K токенов Вход · Чтение кэша $0 / 1K токенов Вход · Запись в кэш $0 / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
{\n "model": "sora-2",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON или SSE
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраняйте все блоки содержимого, подписи рассуждений и фактические ID обращений к инструментам. Собирайте все изменения блоков SSE; первый текстовый блок не является полным выходом.
Сохраняйте ID запросов и ответов, а также заголовки. Общий URL получения текстового задания не предоставлен.
| Поле | Тип |
|---|---|
Полеid | Типstring |
Полеmodel | Типstring |
Полеcontent[] | Типtext|thinking|tool_use|other content block |
Полеstop_reason | Типstring|null |
Полеusage | Типobject |
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНеверные обязательные поля, представление материалов или значение параметра | Следующий шагИсправьте указанные поля перед новым запросом на создание. |
Ailoot Ultra sora-2
Используйте пути методов, указанные выше.