Create a new video job

Initiate a new AI-generated video using a set of public image URLs. Each image will be processed into a video clip and combined together into one video.

Authentication

Authorization: Bearer <YOUR_API_KEY>


Request Body Fields

FieldTypeRequiredDescription
image_inputsarray of ImageInput[]YesList of input images. Each must include a public image_url. Optionally includes camera_motion.
orientationstringNolandscape (default) or portrait
resolutionstringNo720p (default) or 1080p
audio_urlstringNoPublic URL to optional background audio (≤ 15 MB)

ImageInput[] object

FieldTypeRequiredDescription
image_urlstringYesPublicly accessible image URL (≤ 10 MB)
camera_motionstringNopush-in, push-out, or auto (default: auto)

Example Request Body

{
  "image_inputs": [
    {
      "image_url": "https://example.com/image.jpg",
      "camera_motion": "push-in"
    }
  ],
  "orientation": "landscape",
  "resolution": "720p",
  "audio_url": "https://example.com/audio.mp3"
}

Response

Returns a video object.

FieldTypeDescription
uuidstringUnique ID for the video job
statusstringOne of queued, in_progress, complete, error
video_urlstringFinal video URL
video_clipsarrayList of generated clips for each image input
orientationstringlandscapeor portrait
resolutionstring720p or 1080p

Example

{
  "uuid": "a2d456e3-f9ef-4b63-87d3-dcf6c93e4d24",
  "status": "queued",
  "video_url": "",
  "video_clips": [],
  "resolution": "720p", 
  "orientation": "landscape"
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!