Create video with image sora-2
POST
/v1/video/create
Use the sora-2-all video model to create a unified-format video from multiple images and a prompt.
Suitable for quickly turning static images into portrait or landscape short videos.
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
images
string[]
Required
Array of image URLs. Each element must be a publicly accessible image URL.
model
string
Required
Model name, for example 'sora-2-all'.
orientation
string
Required
Video orientation:
- portrait: vertical
- landscape: horizontal
prompt
string
Required
Prompt describing the content and style of the video.
size
string
Required
Video size, e.g. 'small' (around 720p), 'large', etc.
duration
integer
Required
Video duration in seconds, e.g. 10 or 15.
watermark
string
Required
Watermark control:
- Default true: prefers a watermark-free video; falls back to a watermarked version if removal fails.
- Pass false: force watermark-free video; will automatically retry when watermark removal errors occur.
Responses
Video creation task created successfully
application/json
object
id
string
Required
Task ID used to query task status and result.
status
string
Required
Task status, such as 'pending', 'processing', 'succeeded', or 'failed'.
status_update_time
integer
Required
Timestamp in milliseconds when the status was last updated.