Create a video
$ openai videos create
POST
/videosCreate a new video generation job from a prompt and optional reference assets.
Create a video
openai videos create \
--api-key 'My API Key' \
--prompt xResponse example
{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1712697600,
"size": "1024x1792",
"seconds": "8",
"prompt": "A calico cat playing a piano on stage",
"completed_at": null,
"expires_at": null,
"error": null,
"remixed_from_video_id": null
}
Parameters
--model: optional string or "sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more
The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults to sora-2.
Returns Examples
Response example
{
"id": "video_123",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1712697600,
"size": "1024x1792",
"seconds": "8",
"prompt": "A calico cat playing a piano on stage",
"completed_at": null,
"expires_at": null,
"error": null,
"remixed_from_video_id": null
}