Сора 2 Про API

Интегрируйте Sora 2 Pro через API

Создавайте задачи с текстом, изображением или раскадровкой видео с помощью /api/v1/video/sora-pro, затем опрашивайте статус и предоставляйте результаты с помощью check-result.

Все, что вам нужно для доставки Sora 2 Pro

Один API охватывает рабочие процессы Sora 2, Sora 2 Pro и раскадровки с четким выставлением счетов и предсказуемым опросом.

Семь поддерживаемых моделей

Выберите текст/изображение Sora 2, текст/изображение Sora 2 Stable и варианты текста/изображения/раскадровки Sora 2 Pro.

Многоуровневые кредиты

Кредиты масштабируются в зависимости от продолжительности и качества, включая стандартный/высокий для Sora 2 Pro.

Доставка на основе задач

Создайте задачу, опросите результат проверки и отправьте окончательный result_url.

Аутентификация и базовый URL-адрес

Все конечные точки обслуживаются с https://sora2-api.com. Отправьте ключ API из консоли в заголовке Авторизация.

  • Включайте авторизацию: носитель YOUR_API_KEY при каждом запросе.
  • Используйте Content-Type: application/json для полезных данных JSON.
  • Ответы включают код/сообщение/данные; check-result может возвращать 4xx/5xx, поэтому проверьте также статус HTTP.

Кредиты и выставление счетов

Оплата зависит от модели, продолжительности и уровня качества.

  • Текст/изображение Сора 2: 10 с = 100 кредитов, 15 с = 150 кредитов.
  • Сора 2 Стабильный текст/изображение: 10 с = 100 кредитов, 15 с = 150 кредитов.
  • Текст/изображение Sora 2 Pro: 10 с = 375, 15 с = 675.
  • Раскадровка Sora 2 Pro: 10 с = 375, 15 с = 675, 25 с = 875.
  • Цены выше являются окончательными; расходы округляются в большую сторону.

Основные конечные точки

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

Создать видео о Sora 2 Pro

Отправьте текст, изображение или раскадровку, немедленно вычтите кредиты и получите идентификатор задачи.

Метод: POSTПуть: /api/v1/video/sora-pro

Параметры полезной нагрузки

  • модель: Требуется. Используйте одну из поддерживаемых строк модели, указанных выше.
  • подсказка: Требуется, за исключением раскадровки. Опишите сцену, которую вы хотите создать.
  • imageData: требуется для преобразования изображения в видео. URL-адрес данных Base64 с префиксом «data:image/*;base64,».
  • URL-адрес изображения: необязательно. Публичный URL-адрес изображения, если вы предпочитаете не отправлять base64.
  • аспектСоотношение: необязательно. «пейзаж» или «портрет» (пейзаж по умолчанию).
  • нфреймы: необязательно. «10»/«15»/«25» (25 — только раскадровка).
  • размер: необязательно (текст/изображение Pro). «стандартный» или «высокий».
  • RemoveWatermark: Необязательно (текст/изображение). Удалить флаг водяного знака, по умолчанию true.
  • кадры: Требуется для раскадровки. Массив кадров со сценой и длительностью.
  • isPublic: необязательно. Независимо от того, является ли результат общедоступным, по умолчанию true.

Примечания

  • Поддерживаемые модели: sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-раскадровка.
  • Кредиты вычитаются при отправке; невыполненные задания возвращаются автоматически.
  • Для режима раскадровки требуется массив снимков.

Структура кадров

Требуется для запросов раскадровки; каждый элемент определяет сцену и продолжительность.

[
  { "scene": "Уютное кафе на рассвете, теплый свет.", "duration": 7.5 }
]
  • сцена: Описание кадра.
  • продолжительность: секунды (поддерживает десятичные дроби, например 7,5).

Образец запроса

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "Кинематографический кадр, снятый на освещенном неоновым светом уличном рынке в сумерках.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Пример ответа

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

Проверить результат генерации

Опрос статуса задачи и синхронизация результатов.

Метод: POSTПуть: /api/video-generations/check-result

Параметры полезной нагрузки

  • Идентификатор задачи: Обязательно. Идентификатор, возвращенный при создании задачи генерации.

Примечания

  • Возвращает статус, прогресс и result_url, если они доступны.
  • Может возвращать 4xx/5xx для проверки, разрешения или ненайденных случаев.

Образец запроса

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

Пример ответа

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Получите пользовательские кредиты

Получите оставшиеся кредиты и VIP-статус.

Метод: POSTПуть: /api/get-user-credits

Примечания

  • Требуется действительный ключ API или сеанс.
  • Возвращает поля left_credits и is_vip.

Образец запроса

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Пример ответа

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

1. Создайте задачу

Отправьте /api/v1/video/sora-pro со своей полезной нагрузкой, затем сохраните идентификатор задачи.

2. Отслеживайте прогресс

Опрашивайте /api/video-generations/check-result до тех пор, пока статус не будет успешным или неудачным.

3. Доставьте видео

Используйте result_url/result_urls для распространения или хранения сгенерированного видео.

Часто задаваемые вопросы

Какие модели поддерживаются?

Используйте sora-2-text-to-video или sora-2-image-to-video; Sora 2 Pro добавляет варианты текста, изображения и раскадровки.

Какие значения поддерживает nFrames?

Используйте «10» или «15» для всех режимов; «25» предназначено только для раскадровки. Текст/изображение Pro поддерживает стандартный или большой размер.

Почему результат проверки может вернуть 4xx/5xx?

Конечная точка проверяет право собственности и ввод, поэтому недействительные или неавторизованные задачи могут возвращать 4xx/5xx вместе с кодом/сообщением.

Полезные ресурсы

Запуск с помощью Tikdek Video API

Создайте свой ключ API и начните создавать видео Sora 2 Pro за считанные минуты.