Сора 2 API

Создан на базе API Sora 2.

Обеспечьте преобразование текста в видео с помощью OpenAI Sora 2 и Sora Pro. Выполняйте аутентификацию с помощью ключей API, опрашивайте статус задач и доставляйте окончательные видеоролики за считанные минуты.

Почему команды полагаются на API Sora 2

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

Сора 2 + Стабильный + Про

Выберите модельную цепочку, которая соответствует вашим требованиям по качеству и стоимости: sora-2, sora-2-stable или sora-2-pro.

Предсказуемый опрос

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

20 одновременных запросов

Обрабатывайте до 20 задач по созданию видео одновременно. Свяжитесь с нами для более высоких лимитов.

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

Все конечные точки находятся под https://sora2-api.com/api. Укажите ключ API, созданный в консоли, через заголовок авторизации.

  • Отправляйте заголовок Authorization: Bearer YOUR_API_KEY с каждым запросом.
  • Используйте Content-Type: application/json при публикации полезных данных.
  • За каждый запрос на генерацию вычитаются кредиты в зависимости от модели и продолжительности: сора-2/сора-2-стабильная 10 с (100) или 15 с (150), сора-2-про (150); невыполненные задания возвращаются автоматически.

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

Начните с создания задачи генерации, затем опросите или прослушайте результат.

Создать видео Сора 2

Начните работу по созданию Sora 2 или Sora Pro с помощью подсказок для преобразования текста в видео или дополнительных подсказок для преобразования изображения в видео.

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

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

  • model: Обязательно. Используйте «Сора-2», «Сора-2-стабильный» или «Сора-2-про».
  • prompt: Обязательно. Описание сцены, которую вы хотите создать Соре, на естественном языке.
  • imageData: Необязательно (рекомендуется). URL-адрес данных Base64 с префиксом «data:image/*;base64» для режима преобразования изображения в видео.
  • url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
  • aspectRatio: Необязательно. Поддерживаемые значения: «9:16» (по умолчанию) или «16:9».
  • isPublic: Необязательно. Показывать ли видео публично; по умолчанию верно.
  • remixTargetId: Необязательно (только VIP). Целевой идентификатор видео для функций продолжения/ремикса.
  • characters: Необязательно (только VIP). Массив управления персонажем; каждый элемент включает URL-адрес и временные метки.

Примечания

  • Ответы возвращаются немедленно с идентификатором задачи; результат проверки опроса до тех пор, пока статус не будет успешным или неудачным.

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

curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

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

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

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

Опросите последний статус задачи создания, чтобы отслеживать ход выполнения и получать результаты.

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

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

  • taskId: Необходимый. Идентификатор, возвращенный при создании задачи генерации.

Примечания

  • Конечная точка проверяет, принадлежит ли задача вашей учетной записи, прежде чем возвращать данные.
  • Невыполненные задания автоматически возвращают кредиты и предоставляют метаданные возврата в ответе.

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

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": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

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

Запросите доступные кредиты текущего пользователя и статус VIP-членства.

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

Примечания

  • Для доступа к информации пользователя требуется действительный сеанс входа в систему или токен API.
  • Возвращает поля статуса left_credits, is_recharged, is_pro и 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_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}

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

Отправьте запрос Tikdek с приглашением, а затем сохраните возвращенный идентификатор задачи.

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

Вызывайте конечную точку результата проверки до тех пор, пока статус не станет успешным или неудачным.

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

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

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

Как мне подтвердить свои запросы?

Создайте ключ API в консоли, затем включите его в качестве авторизации: предъявитель YOUR_API_KEY. Ключи можно поворачивать в любое время.

Как я должен опросить результаты?

После вызова create сохраните идентификатор задачи. Вызывайте /api/video-generations/check-result каждые 3–5 секунд, пока статус не будет успешным или неудачным, затем используйте result_url/result_urls.

Как распределяются кредиты в случае неудач?

Мы автоматически возвращаем кредиты в случае сбоя задачи и возвращаем return_trans_no плюс Credits_refunded=true в полезных данных результатов проверки для контрольного журнала.

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

Запустите Tikdek сегодня

Создайте свой ключ API и начните создавать кинематографические видеоролики с искусственным интеллектом за считанные минуты.