Skip to main content
POST
Image to Video
You can also submit through the unified task endpoint POST /v1/task/submit with model set to midjourney-video and the parameters inside input. Both behave and bill the same.
The response carries a task ID. Fetch the result with Get Task, or pass notify_hook when submitting. When the task succeeds, actions in the result lists what you can do next through Image Actions. This endpoint starts from your own image. To start from an image in an existing task, or to extend a video, call Image Actions with action set to video or video-extend.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
image
string
required

First Frame: An image URL (publicly reachable) or a base64 data URI, up to 20 MB each.

prompt
string

Prompt: Optional: describe the motion. Without it, motion is generated automatically.

Maximum string length: 6000
resolution
enum<string>
default:480p

Resolution: 480p (default) or 720p (3.2x price).

Available options:
480p,
720p
motion
enum<string>
default:low

Motion: low (default, subtle motion) or high (large camera motion).

Available options:
low,
high
batch_size
enum<integer>
default:1

Batch Size: Videos per task: 1 (default), 2 or 4; priced by count.

Available options:
1,
2,
4
end_image
string

End Frame: Optional end frame. An image URL (publicly reachable) or a base64 data URI, up to 20 MB each.

loop
boolean
default:false

Loop: Make a seamless loop; cannot be combined with end_image.

speed
enum<string>
default:fast

Speed: Video supports fast and turbo only. You can also write --fast / --turbo in the prompt; this field wins.

Available options:
fast,
turbo
notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

task_id
string
required

Task ID.

action
string
required

Action name, e.g. imagine, upscale.

status
enum<string>
required

Task status, see the table above.

Available options:
submitted,
in_progress,
success,
failure
created_at
integer
required

Created at (Unix seconds).