Retrieve a video job

Retrieve the status and details of a video using its UUID.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Authentication

Authorization: <YOUR_API_KEY>


Path Parameter

ParameterTypeRequiredDescription
video_uuidstringYesUUID of the video you created

Response

FieldTypeDescription
uuidstringUnique ID of the video
projectstringUUID of the project this video belongs to.
statusstringOne of: queued, in_progress, complete, error
video_urlstringFinal stitched video URL
orientationstringlandscape or portrait
resolutionstring720p or 1080p
ai_enginestringv24 or v25
video_clipsarray of VideoClip[]List of individual clips per video

Example response

{
  "uuid": "9734b67c-54c6-454d-8874-120063af4a07",
  "project": "b1f2c3d4-5678-4abc-9def-0123456789ab",
  "status": "queued",
  "video_url": "",
  "video_clips": [],
  "resolution": "720p",
  "orientation": "landscape",
  "ai_engine": "v25"
}

VideoClip object

FieldTypeDescription
uuidstringUUID of the video clip
clip_urlstringURL of the generated video clip
image_urlstringURL of the source image for that clip
camera_motionstringpush-in, push-out, orbit-left, orbit-right, auto
orientationstringlandscape or portrait
resolutionstring720p or 1080p
ai_enginestringv24 or v25
vfxobject|nullThe VFX applied to that clip, e.g. {"type": "word-drop", "config": {"text": "FOR SALE", "color": "gold"}}, or null if none

Path Params
uuid
required

UUID of the video

Responses

404

Video not found or not owned by user

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json