Video Generation

POST/v1/run

Generate videos using AI models. Video generation is asynchronous — you submit a request and poll for results.

Request body

stringmodelrequired

Model name (e.g. kling/v2, wan/2.1)

stringpromptrequired

Text description of the video

Optional<number>duration

Video duration in seconds

Optional<string>image_url

Reference image for image-to-video

Optional<string>webhook_url

Public HTTPS callback URL for this async task only

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling/v2","prompt":"A cat playing piano","duration":5}'

Response202 Accepted

{
  "id": "task_01...",
  "status": "pending",
  "model": "kling/v2"
}