通过文本、图像或视频创建 Omni 视频

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
}

使用此 Beta 端点创建文生视频、图生视频或视频转视频任务。API 会立即返回任务 ID，因此请保存返回的 id 并轮询任务，直到其达到终止状态。选择与输入模式匹配的请求内容类型。将文生视频和图生视频控制参数作为 multipart/form-data 字段发送。将参考视频编辑作为 application/json 请求正文发送。

选择输入模式

目标	内容类型	必填字段	可选字段
文生视频	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
图生视频	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
视频转视频	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

文生视频和图生视频示例使用 model=omni-fast。视频转视频示例使用 model=omni-fast-v2v。请使用列出可用模型来确认某个模型 ID 是否对您的 API 密钥可见。

为参考图像添加动画

对于图生视频，请使用 model=omni-fast，并在 multipart input_reference 字段中上传一个 PNG 文件。对于文生视频，该字段仍为可选；但当参考图像应引导生成的视频时，该字段为必填。将 prompt 聚焦于要添加的运动，并明确说明结果应保留的颜色、形状、主体或构图。代码示例选择器提供 Shell、Python 和 JavaScript 示例，这些示例会从工作目录上传 reference.png 并创建任务。此请求结构仅涵盖一个上传的 PNG 文件。它未规定 URL 输入、其他图像格式、多个参考图像或文件大小限制。

编辑参考视频

对于视频转视频，将本地 MP4 文件编码为 base64，并在编码后的字节前添加 data:video/mp4;base64,。在 video 字段中发送完整的数据 URL。在 prompt 中描述请求的更改。同时说明结果应保留的主体、对象、构图或运动。代码示例选择器提供 Shell、Python 和 JavaScript 示例，这些示例会从工作目录读取 reference.mp4。此请求结构涵盖内联 MP4 数据 URL。它未规定 URL 输入、其他视频容器格式或文件大小限制。

设置时长、比例和分辨率

Omni 被标记为 beta，因为生成稳定性可能因输入和所选路由而异。请保持首次请求规模较小，然后检查已完成的视频，再依赖特定的渲染时长或帧大小。

设置	支持的值	默认值	边界行为
`seconds`	从以下值开始 `4`	因路由而异	将其视为请求的时长，并验证已完成的 MP4，因为输出时长可能有所不同。
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` 可以渲染为纵向输出。`1:1` 也可以被接受，但会以横向方式渲染。
`resolution`	建议从 `720p` 开始；也可以接受 `1080p`	`720p`	即使请求了 `720p`，当前生产输出也可能会规范化为 `1080p`。

请求	实测完成帧
`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`

由于此端点处于 beta 状态，请将 aspect_ratio 和 resolution 视为生成偏好设置，并在依赖最终像素前验证下载的 MP4。

任务流程

创建任务

使用所选输入模式对应的内容类型发送请求，并存储返回的 id。

轮询任务

调用检索 Omni 视频，直到 status 为 completed 或 failed。

下载结果

当任务处于 completed 状态时，调用检索 Omni 视频内容以下载 MP4 文件。

授权

Authorization

string

header

必填

Bearer authentication. Use your CometAPI API key.

请求体

model

string

必填

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

示例:

"omni-fast"

prompt

string

必填

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

示例:

"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.

示例:

"4"

aspect_ratio

enum<string>

默认值: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.

可用选项:

16:9,

9:16,

1:1

示例:

"16:9"

resolution

string

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

示例:

"720p"

响应

200 - application/json

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

string

必填

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

示例:

"task_example"

object

string

必填

Object type. Video tasks return video.

示例:

"video"

model

string

必填

Model ID used for the task.

示例:

"omni-fast"

status

enum<string>

必填

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

可用选项:

queued,

in_progress,

completed,

failed,

error

示例:

"queued"

progress

integer

必填

Task progress as a coarse percentage.

必填范围: 0 <= x <= 100

示例:

0

created_at

integer

必填

Task creation time as a Unix timestamp in seconds.

示例:

1779938152

task_id

string

Compatibility alias for id when present.

示例:

"task_example"

completed_at

integer

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

示例:

1779938219

video_url

string

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

示例:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

最后修改于 2026年8月4日

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
}

​选择输入模式

​为参考图像添加动画

​编辑参考视频

​设置时长、比例和分辨率

​任务流程

授权

请求体

响应

选择输入模式

为参考图像添加动画

编辑参考视频

设置时长、比例和分辨率

任务流程