Authentication

Authorization: <YOUR_API_KEY>

Request Body Fields

Field	Type	Required	Description
`image_inputs`	array of ImageInput[]	Yes	List of input images. Each must include a public `image_url`. Optionally includes `camera_motion`.
`orientation`	string	No	`landscape` (default) or `portrait`
`resolution`	string	No	`720p` (default) or `1080p`
`audio_url`	string	No	Public URL to optional background audio (≤ 15 MB)
`ai_engine`	string	No	AI Engine powering the video. `v24` is standard and default, `v25` is experimental and more accurate.

`ImageInput[]` object

Field

Type

Required

Description

image_url

string

Yes

Publicly accessible image URL (≤ 10 MB)

camera_motion

string

No

push-in, push-out, orbit-left, orbit-right, or auto.

Note: orbit-left and orbit-right are only available with v25.

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",
	"ai_engine": "v25"
}

Response

Returns a video object.

Field	Type	Description
`uuid`	string	Unique ID for the video job
`status`	string	One of `queued`, `in_progress`, `complete`, `error`
`video_url`	string	Final video URL
`video_clips`	array	List of generated clips for each image input
`orientation`	string	`landscape`or `portrait`
`resolution`	string	`720p` or `1080p`
`ai_engine`	string	`v24` or `v25`

Example

{
  "uuid": "a2d456e3-f9ef-4b63-87d3-dcf6c93e4d24",
  "status": "queued",
  "video_url": "",
  "video_clips": [],
  "resolution": "720p", 
  "orientation": "landscape",
	"ai_engine": "v25"
}

201Job accepted (queued)