Предсказуемый опрос
Создайте задачу, а затем опросите конечную точку результатов проверки, чтобы синхронизировать состояние и прогресс без SSE.
Асинхронная доставка
Надёжные видео-задачи со статусами и webhooks
Используйте опрос для простых клиентов или webhooks для автоматической доставки.
Создать задачу с webhook
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",
"prompt": "A tracking shot through a quiet night market",
"aspectRatio": "16:9",
"webHook": "https://api.example.com/webhooks/video",
"isPublic": false
}'
# Your webhook receives a terminal payload:
{
"id": "task_123",
"status": "succeeded",
"progress": 100,
"results": [{ "url": "https://storage.example/video.mp4" }]
}Один цикл, два способа доставки
Сохраняйте каждый ID и считайте succeeded и failed конечными состояниями.
20 одновременных запросов
Обрабатывайте до 20 задач по созданию видео одновременно. Свяжитесь с нами для более высоких лимитов.
Прозрачный биллинг
Каждый вызов стоит 100 кредитов за 10 с сора-2/сора-2-стабильный, 150 кредитов за 15 с сора-2/сора-2-стабильный или 150 кредитов за сора-2-про, с автоматическим возвратом средств в случае сбоя генерации.
Рекомендуемый порядок интеграции
Правила доставки webhook
Быстро отвечайте 2xx, обрабатывайте идемпотентно и сохраняйте опрос как запасной путь.
Создайте задачу
Отправьте запрос Tikdek с приглашением, а затем сохраните возвращенный идентификатор задачи.
Отслеживайте прогресс
Вызывайте конечную точку результата проверки до тех пор, пока статус не станет успешным или неудачным.
Доставьте видео
Используйте 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 в полезных данных результатов проверки для контрольного журнала.
Запустите устойчивую асинхронную генерацию
Начните с опроса и добавьте webhooks без изменения контракта генерации.