Skip to main content

​
Get Video Status

Retrieves the current status of a video generation job. 
GET https://api.runcrate.ai/v1/videos/{id}

​
Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique identifier of the video generation job returned by Create Video.

​
Example Request

curl https://api.runcrate.ai/v1/videos/vid_abc123 \
  -H "Authorization: Bearer rc_live_YOUR_API_KEY"

​
Response

{
  "id": "vid_abc123",
  "status": "completed"
}
FieldTypeDescription
idstringUnique identifier for the video generation job.
statusstringCurrent status of the job.

​
Status Values

StatusDescription
queuedThe job is waiting to be processed.
processingThe video is actively being generated.
completedGeneration is finished. The video is ready to download.
failedGeneration failed. Check the error details or retry.

​
Polling

Video generation can take anywhere from 30 seconds to several minutes depending on the model and parameters. We recommend polling every 5-10 seconds: 
# Poll until completion
while true; do
  STATUS=$(curl -s https://api.runcrate.ai/v1/videos/vid_abc123 \
    -H "Authorization: Bearer rc_live_YOUR_API_KEY" | jq -r '.status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    break
  fi
  sleep 5
done