Turn one still photo into a short animated clip.
Upload an image, describe the motion, get back a 5-second 720p MP4. 11,879 credits per clip, available on paid plans (Starter and up).
Image in, motion prompt in, MP4 out. Asynchronous: submit a job, then poll for the result.
720p MP4, 5 seconds long (duration is fixed at 5 s).
PNG, JPG or WebP, max 20 MB. Shortest side at least 256 px; aspect ratio between 1:3 and 3:1.
Describe what should move and how (camera and subject), up to 1,500 characters.
Usually a few minutes per clip (no guarantee). Paid plans only; failed clips are refunded automatically.
Start from a sharp, well-lit image with one clear subject. In the prompt, say what should move and how the camera should behave, for example “the perfume bottle slowly turns on the marble pedestal, smooth camera push-in” or “morning mist drifts through the valley, gentle forward camera glide”. Short, concrete motion descriptions work best.
Authenticate with Authorization: Bearer YOUR_API_KEY (create a key in the dashboard). Submit the job, then poll until status is completed or failed.
Alias: POST /v1/video/i2v. Accepts multipart/form-data, or a JSON body with image_url or image_base64. The response contains generation_id, status: "processing" and poll_url.
| Field | Type | Required | Description |
|---|---|---|---|
image | file | one of | Input image (PNG/JPG/WebP, max 20 MB, shortest side ≥ 256 px, aspect 1:3 to 3:1). |
image_url | string | one of | Public http/https URL of the input image (multipart or JSON). |
image_base64 | string | one of | Base64-encoded image (JSON body only). |
prompt | string | yes | Describe the motion, max 1,500 characters. |
duration | integer | no | Fixed at 5 (seconds). Other values return 400. |
When status is completed, output_url is the MP4. Requires a paid plan (Starter and up); free-trial accounts receive an error and are not charged.
Billed in credits. 1 credit = $0.001 on the Starter plan; the cash value of a credit depends on your plan. Failed or safety-withheld clips are refunded automatically.
11,879 credits per 5-second clip ($11.88 at 1 credit = $0.001 on the Starter plan). Failed or safety-withheld clips are refunded automatically.
Paid plans only (Starter and up). The free trial credits cannot be used for image-to-video.
Usually a few minutes (no guarantee). The API is asynchronous: submit, then poll GET /v1/video/{generation_id} until status is completed or failed.
A 720p MP4, 5 seconds long. Duration is fixed at 5 seconds.
PNG, JPG or WebP, up to 20 MB, with the shortest side at least 256 px and an aspect ratio between 1:3 and 3:1. Send a file as image, or a public http/https URL as image_url (JSON bodies may use image_url or image_base64).
Yes. Nudity and sexual content are blocked: the input image and the prompt are checked before rendering. Blocked requests are not charged.
No. This endpoint needs an input image; the prompt describes how it should move.
Image-to-video is available on paid plans, starting with Starter. See pricing.