Create video
POST
https://api.cometapi.com/v1/videos
Maintainer:Not configured
Overview
videos is OpenAI Sora's video generation interface that creates video generation tasks through text prompts or optional reference image inputs. After creation, you need to use the query interface to get the generation status.Once the video has been created, you need to call /v1/videos/{video_id}/content again to retrieve the video content.Supported Models
sora-2 sora-2-proImportant Notes
Video generation requires considerable time and uses asynchronous mode. After creating a task, a task ID is returned immediately. You need to use the query interface to get generation progress and results.
Generated video content must comply with OpenAI's usage policies. Content that is illegal, violent, pornographic, or infringes on copyrights is prohibited.
If you receive
Your request was blocked by our moderation system., this error is returned by OpenAI's official moderation system due to non-compliant input parameters. Please adjust your request parameters (e.g., modify the prompt content, change reference images) and try again.Best Practices
1.
2.
3.
4.
5.
6.
FAQ
A: Typically takes several minutes to over ten minutes, depending on video duration, resolution, and server load. If there's no response for a long time or failure occurs, please contact customer service.
A: Default support for
720x1280. For specific supported resolutions, please refer to the model documentation.A: Default is 4 seconds. Maximum duration depends on model limitations, please refer to official documentation.
A: Use detailed prompts, choose appropriate duration, and provide high-quality reference images.
š Storyboard Mode
Shot 1:
duration: 7.5sec
Scene: The plane takes off.
Shot 2:
duration: 7.5sec
Scene: The plane lands.Shot N: (N is the shot number)duration: Xsec to specify shot durationScene: to describe the shot contentRequest
Header Params
Body Params multipart/form-data
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cometapi.com/v1/videos' \
--header 'Authorization: ' \
--form 'prompt="cat"' \
--form 'model="sora-2"' \
--form 'seconds="4"' \
--form 'size="720x1280"'Response Response Example
{
"id": "video_68e688d4950481918ec389280c2f78140fcb904657674466",
"object": "video",
"created_at": 1759938772,
"status": "queued",
"completed_at": null,
"error": null,
"expires_at": null,
"model": "sora-2",
"progress": 0,
"remixed_from_video_id": null,
"seconds": "4",
"size": "720x1280"
}Modified atĀ 2026-02-18 05:15:17