Sora 2 Official

Используйте sora-2-official для создания видеовыхода. Эта страница содержит полный запрос, необходимый для этой модели.

Факты о модели

Свойство	Значение
Идентификатор модели	`sora-2-official`
Эндпоинт	`POST /api/v1/generation/create`
Выход	Видео
Режимы	текст-видео, изображение-видео
Цены	Посмотреть текущие цены

Минимальный запрос

curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sora-2-official",
  "input": {
    "prompt": "A quiet street after summer rain",
    "aspectRatio": "16:9"
  }
}'

Ответ на создание содержит идентификатор задачи:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Параметры

Параметры должны находиться внутри объекта верхнего уровня input. Неизвестные поля отклоняются.

Параметр	Тип	Обязательно	По умолчанию	Описание
`prompt`	струна	Да	—	Подсказка пользователя
`aspectRatio`	“16:9” \| “9:16”	Нет	`"16:9"`	Соотношение сторон
`urls`	string[]	Нет	—	Ссылки на изображения (максимум 1)
`duration`	4 \| 8 \| 12 \| 16 \| 20	Нет	`4`	Длительность видео в секундах

Режимы

Минимальная генерация

{
  "model": "sora-2-official",
  "input": {
    "prompt": "A quiet street after summer rain",
    "aspectRatio": "16:9"
  }
}

С URL

{
  "model": "sora-2-official",
  "input": {
    "prompt": "A quiet street after summer rain",
    "aspectRatio": "16:9",
    "urls": ["https://example.com/input.jpg"]
  }
}

Ограничения

aspectRatio: разрешено: 16:9, 9:16.
duration: разрешено: 4, 8, 12, 16, 20.

Неверные типы, неподдерживаемые значения перечислений, числа вне диапазона и отсутствующие обязательные поля возвращают HTTP 400 с error.code: "invalid_input". Исправьте запрос, а не пытайтесь выполнить его повторно без изменений.

Результат

Определите задачу или предоставьте верхнеуровневый URL webhook в запросе на создание:

curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

Успешная медиа-задача возвращает один или несколько файлов:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://storage.api-stock.com/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Смотрите Задачи и вебхуки для терминальных статусов, повторных попыток и доставки вебхуков.