Status and webhooks
Deliver asynchronous video results with polling or callback URLs.
Polling
Send webHook: "-1" when creating a standard video task. Then call:
POST /api/video-generations/check-result
{ "taskId": "TASK_ID" }Poll every 3-5 seconds with a bounded timeout. Store the task ID before starting the loop.
Webhooks
Pass a reachable HTTPS URL in webHook. Tikdek posts the terminal task payload when generation succeeds or fails.
Your handler should:
- Return a 2xx response quickly
- Process the task ID idempotently
- Store the result URL before downstream work
- Keep polling available as a recovery path
Webhook delivery currently applies to /api/v1/video/sora-video.