跳转到主要内容
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'
{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

使用本页通过共享的 CometAPI /v1/videos 路由启动一个 Veo 任务。设置 model 时，请从模型页面选择一个当前可用的 Veo 别名。

​
选择请求模式

  • 文本生成视频：不发送 input_reference 文件
  • 图片生成视频：发送一个 input_reference
  • 首帧和尾帧引导：按顺序发送两个 input_reference 文件

​
任务流程

1

提交 Veo 任务

发送 Veo 别名、prompt 以及可选的图片输入，然后保存返回的 id。
2

轮询共享视频端点

使用 Veo3 Retrieve 跟踪异步任务，直到其进入终态。
3

持久化结果

如果你的应用需要持久副本，请将完成的资源转移到你自己的存储中。

​
别名解析

响应中的 model 字段可能显示解析后的后端模型 id，而不是你提交的别名。请使用模型页面查找当前可用的 Veo 别名。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

multipart/form-data
​
prompt
string
必填

Text prompt for the video job.

示例:

"A paper kite floats above a field."

​
model
string
默认值:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

示例:

"veo3-fast"

​
size
string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

示例:

"16x9"

​
input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

响应

200 - application/json

Task accepted.

​
created_at
integer
必填
​
id
string
必填
​
model
string
必填

Provider model identifier resolved by CometAPI for this task.

​
object
string
必填
​
progress
integer
必填
​
seconds
string
必填
​
size
string
必填
​
status
string
必填