Video API

Request fields, model options, and result handling for Tikdek video generation.

Create a standard task

POST /api/v1/video/sora-video

FieldRequiredDescription
modelYessora-2, sora-2-stable, or sora-2-pro
promptYesNatural-language scene and motion description
urlNoReachable reference image URL for image-to-video
imageDataNoBase64 data URL for image-to-video
aspectRatioNo16:9 or 9:16
webHookNoCallback URL, or -1 for polling
isPublicNoWhether the result may appear in the public gallery

Create a Pro task

POST /api/v1/video/sora-pro

The Pro endpoint supports text-to-video, image-to-video, high-quality output, and storyboard requests. See the Sora 2 Pro API page for full payload examples.

Status response

The status endpoint returns task state, progress, result URLs, failure details, and refund metadata. Treat succeeded and failed as terminal states.