Create an Omni video from text, image, or video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Use this beta endpoint to create a text-to-video, image-to-video, or video-to-video task. The API returns a task ID immediately, so store the returned id and poll the task until it reaches a terminal status. Choose the request content type that matches the input mode. Send text-to-video and image-to-video controls as multipart/form-data fields. Send a reference-video edit as an application/json body.

Choose an input mode

Goal	Content type	Required fields	Optional fields
Text-to-video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Image-to-video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Video-to-video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

The text-to-video and image-to-video examples use model=omni-fast. The video-to-video examples use model=omni-fast-v2v. Use List available models to confirm that a model ID is visible to your API key.

Animate a reference image

For image-to-video, use model=omni-fast and upload one PNG file in the multipart input_reference field. The field remains optional for text-to-video, but it is required when a reference image should drive the generated video. Focus the prompt on the motion to add and explicitly name the colors, shapes, subjects, or composition that the result should preserve. The code sample selector includes Shell, Python, and JavaScript examples that upload reference.png from the working directory and create the task. This request shape covers one uploaded PNG. It does not define URL input, other image formats, multiple reference images, or file-size limits.

Edit a reference video

For video-to-video, encode a local MP4 file as base64 and prefix the encoded bytes with data:video/mp4;base64,. Send the complete data URL in the video field. Describe the requested changes in prompt. Also name the subjects, objects, composition, or motion that the result should preserve. The code sample selector includes Shell, Python, and JavaScript examples that read reference.mp4 from the working directory. This request shape covers an inline MP4 data URL. It does not define URL input, other video container formats, or file-size limits.

Set duration, ratio, and resolution

Omni is marked beta because generation stability can vary by input and selected route. Keep the first request small, then inspect the completed video before relying on a specific rendered duration or frame size.

Setting	Supported values	Default	Boundary behavior
`seconds`	Start with `4`	Route-dependent	Treat this as a requested duration and verify the completed MP4 because the output duration can differ.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` can render portrait output. `1:1` can be accepted while rendering as landscape.
`resolution`	Start with `720p`; `1080p` can be accepted	`720p`	Current production output can normalize to `720p` even when `1080p` is requested.

Request	Observed completed frame
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Because this endpoint is beta, treat aspect_ratio and resolution as generation preferences and verify the downloaded MP4 before depending on final pixels.

Task flow

Create the task

Send the request with the content type for the selected input mode and store the returned id.

Poll the task

Call Retrieve an Omni video until status is completed or failed.

Download the result

When the task is completed, call Retrieve Omni video content to download the MP4 file.

Authorizations

Authorization

string

header

required

Bearer authentication. Use your CometAPI API key.

Body

model

string

required

Omni model ID for this endpoint. Use omni-fast for text-to-video and image-to-video.

Example:

"omni-fast"

prompt

string

required

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Example:

"Ocean waves rolling onto a sandy beach at golden hour"

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Example:

"4"

aspect_ratio

enum<string>

default:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Available options:

16:9,

9:16,

1:1

Example:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Example:

"720p"

Response

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

string

required

Task ID. Use this value with retrieve and content endpoints.

Example:

"task_example"

object

string

required

Object type. Video tasks return video.

Example:

"video"

model

string

required

Model ID used for the task.

Example:

"omni-fast"

status

enum<string>

required

Task lifecycle status. Poll until the value is completed, failed, or error.

Available options:

queued,

in_progress,

completed,

failed,

error

Example:

"queued"

progress

integer

required

Task progress as a coarse percentage.

Required range: 0 <= x <= 100

Example:

0

created_at

integer

required

Task creation time as a Unix timestamp in seconds.

Example:

1779938152

task_id

string

Compatibility alias for id when present.

Example:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Example:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Example:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Last modified on August 4, 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Content moderation

API keys

Create an Omni video from text, image, or video

Choose an input mode

Animate a reference image

Edit a reference video

Set duration, ratio, and resolution

Task flow

Authorizations

Body

Response

​Choose an input mode

​Animate a reference image

​Edit a reference video

​Set duration, ratio, and resolution

​Task flow

Authorizations

Body

Response

Choose an input mode

Animate a reference image

Edit a reference video

Set duration, ratio, and resolution

Task flow