Skip to main content
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720
{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}
Use this endpoint to start a Sora render job from text, or from text plus one reference image. The API returns a video id immediately and does not wait for the render to finish.

​
Start with the smallest useful job

  • Use sora-2 for faster iteration or sora-2-pro when output quality matters more than speed
  • Keep seconds at 4 for your first request
  • Start with size: 1280x720 unless you specifically need portrait output
  • Upload at most one reference image

​
Duration and size

SettingSupported valuesDefault starting pointBoundary behavior
seconds4, 8, 12, 16, 204Other values are not part of the Sora video request shape.
size for sora-21280x720, 720x12801280x720Use landscape or portrait orientation.
size for sora-2-pro1792x1024, 1024x1792, plus the standard Sora sizes1792x1024 for landscape Pro outputUse the larger Pro sizes only with a Pro model.
Sora requires the size field in exact WxH form. Resolution tokens such as 720p and ratio labels such as 16:9 are not valid Sora size values on this endpoint.

​
End-to-end flow

1

Create the render job

Send model, prompt, seconds, and size, then save the returned id.
2

Poll until the job finishes

Call Retrieve Video until the status becomes completed or failed.
3

Download or remix the result

When the render is done, fetch the file with Retrieve Video Content. If you want a targeted variation, use Remix Video on the completed result.

​
Sora behavior that still applies

OpenAI documents the same create -> retrieve -> download flow in the Videos API. On CometAPI you keep the Sora request shape, but use the CometAPI base URL and key. Finished download URLs are temporary, so copy completed assets into your own storage if you need long retention.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
prompt
string
required

Text prompt that describes the video you want to create.

Example:

"A paper airplane glides across a desk."

​
model
string
default:sora-2

Sora model ID. Choose an available model from the Models page.

Example:

"sora-2"

​
seconds
enum<string>
default:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Available options:
4,
8,
12,
16,
20
Example:

"4"

​
size
enum<string>
default:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Available options:
720x1280,
1280x720,
1024x1792,
1792x1024
Example:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Response

200 - application/json

Video job accepted.

​
created_at
integer
required
​
id
string
required
​
model
string
required
​
object
string
required
​
progress
integer
required
​
seconds
string
required
​
size
string
required
​
status
string
required