Skip to main content
POST
cURL
Начните с этой страницы, если вам нужен основной эндпоинт для генерации видео в Sora 2 API. Полный список эндпоинтов, рекомендации по рабочему процессу и связанные ссылки см. в обзоре Sora 2 API.

Authorizations

TT-API-KEY
string
header
required

Вы можете получить API-ключ в панель управления TTAPI.

Body

application/json

Примечание. Синхронный ответ интерфейса генерации видео Sora не является конечным результатом выполнения задачи. Окончательный результат необходимо получить через асинхронное уведомление с использованием параметра hookUrl или путем запроса через интерфейс результат задачи Sora [blocked].

model
enum<string>
required

sora-2 нормальный режим sora-2-pro HD-режим

Available options:
sora-2,
sora-2-pro
Example:

"sora-2"

prompt
string
required

Описание видео

referImages
string[]

Массив эталонных изображений. ** нельзя передавать реальные изображения с аватарами или существующими логотипами продуктов США. Согласно правилам OpenAI, изображения не соответствующие требованиям приведут к сбою задачи. В настоящее время используется только первый URL**

orientation
enum<string>

Видеоориентация. В режиме sora-2 разрешение видео в портретной ориентации составляет примерно 7201280, в альбомной — аналогичное соотношение. В режиме sora-2-pro разрешение видео в портретной ориентации составляет примерно 10241792, в альбомной — аналогичное соотношение.

Available options:
portrait,
landscape
duration
integer

Продолжительность видео в секундах. 25 с работает только в модели sora-2-pro
Поддерживаемые значения: 10, 15, 25
Значение по умолчанию: 10 с для модели sora-2, 15 с для модели sora-2-pro

size
enum<string>
default:small

Настройка качества видео. Поддерживается только в режиме sora-2-pro. В течение 25 секунд доступно только стандартное качество.

Available options:
small,
large
character_url
string

Видео URL для создания персонажа
Важно: в видео не должно быть реальных людей, иначе задание не будет выполнено

character_timestamps
string

Диапазон времени в секундах появления персонажа в видео, формат: {start},{end}. Примечание. Диапазон end-start должен составлять от 1 до 3 секунд.

Example:

"1,3"

private
boolean
default:true

Настройка конфиденциальности для созданного видео. true — частный доступ, false — публичный доступ

hookUrl
string

Уведомление об обратном вызове URL. Когда задача будет завершена или не выполнена, этот URL будет уведомлен. Структура данных уведомления [blocked] соответствует структуре выборки. Если не установлено, вам необходимо запросить интерфейс получение результата [blocked] для запроса.

Response

Запрос выполнен успешно

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on June 12, 2026