Create video

POST /openai/v1/videos● Supported

Request body

modelstring可选◐ Partially supported
Video model id, for example `wan2.7-t2v`; list candidates with listModels?type=video. Router support (partial): Select a registered video model explicitly, for example wan2.7-t2v (size=1280x720, seconds=4). Capability preflight errors are reported before creation.
Select a registered video model explicitly, for example wan2.7-t2v (size=1280x720, seconds=4). Capability preflight errors are reported before creation.
promptstring必填
Text description of the video, at least 1 character. Router support (supported): Controls video content; missing or empty values return 400.
Controls video content; missing or empty values return 400.
secondsstring | integer可选
When both are supplied, seconds overrides duration.
Duration works on wan2.7-t2v; malformed values or values outside model capabilities return 400 during preflight.
durationinteger可选
Length of the video in whole seconds. `seconds` takes precedence when both are given.
sizestring可选◐ Partially supported
Output resolution as `WIDTHxHEIGHT`, for example `1280x720`. Router support (partial): Subject to model capability preflight. Earlier wan2.7-t2v samples always produced 1280x720; accepted sizes are not guaranteed pixel-for-pixel.
Subject to model capability preflight. Earlier wan2.7-t2v samples always produced 1280x720; accepted sizes are not guaranteed pixel-for-pixel.
input_referencestring | object可选
Reference image for image-to-video: a URL or base64 data URL, an object with `image_url`, or an uploaded image file (multipart, at most 20 MiB).
▸ 展开子字段（1）
- image_urlstring | object必填
  URL or base64 data URL of the reference image, as a string or an object with `url`.
input_referencesarray可选
Several reference images; each entry is a URL or base64 data URL, or an object with `image_url`.
▸ 展开子字段（1）
- image_urlstring | object可选
  URL or base64 data URL of the reference image, as a string or an object with `url`.
frame_imagesarray可选
Images that pin the first and last frame; at most 2 entries.
▸ 展开子字段（3）
- typeany可选
  Always `image_url`. Discriminator of the `type`-tagged union this object belongs to.
- frame_typeany必填
  Frame to constrain with the supplied image: first_frame or last_frame. Each frame type may occur at most once.
  取值 first_framelast_frame
- image_urlobject必填
  The image to pin.
resolutionstring可选
Output resolution label such as `720p`, for models that take a label instead of `size`.
aspect_ratiostring可选
Aspect ratio of the video such as `16:9`.
▸ 更多参数（4）
- generate_audioboolean可选
  Whether the video carries a generated audio track. Router support (supported): false produces no audio track on wan2.7-t2v; the default output includes audio.
  false produces no audio track on wan2.7-t2v; the default output includes audio.
- seedinteger可选
  Seed for reproducible generation, on models that support it.
- callback_urlstring可选
  HTTP or HTTPS callback URL, forwarded to models that support completion callbacks.
- qualitystring可选
  Provider-specific quality setting.

Returns

200 video

Generates video asynchronously: create a job, poll its status, then download the content. Billed per second of output; GET /model/v1/models exposes pricing.video_second in USD per second. Select a registered video model explicitly, for example wan2.7-t2v.

Errors follow the OpenAI format — see error codes

Response

HTTP 200

Success

application/json

Name	Type	Description
id	string	Id of the video job; pass it as `video_id` to retrieve, download or delete it.
object	string	Object type; always `video`.
model	string	Model that generates the video.
status	string	Lifecycle of the job. Poll until it is `completed` or `failed`.
progress	integer	Progress from 0 to 100. It is 0 until the job completes and 100 once it has.
created_at	integer	Unix time in seconds at which the job was created.
completed_at	integer \| null	Unix time in seconds at which the job completed; null until then.
expires_at	integer \| null	Unix time in seconds after which the output expires; null because outputs currently have no expiry.
seconds	string	Length of the video in seconds, as a string; for a completed job it is the delivered length.
size	string	Resolution of the video as `WIDTHxHEIGHT`; null when the provider did not report one.
prompt	string \| null	Prompt the job was created with.
remixed_from_video_id	null	Always null; remix is not supported.
error	object \| null	Why the job failed; null unless status is `failed`.
error.code	string	Machine-readable failure code.
error.message	string	Human-readable failure message.
polling_url	string	Relative URL to poll for the job state; same as retrieveVideo for this job.
unsigned_urls	array<string>	Relative URLs of the finished output; empty until the video is ready. Download them with the same API key.
usage	object	Cost of the job; present once a price applies.
usage.cost	number	Cost of the job in USD: delivered seconds times the per-second price once completed, 0 while running.