CometAPI 封装库
异步视频生成
在 CometAPI 中通过 POST /v1/videos 异步生成 Veo3 视频，返回任务 id，并支持针对 8 秒片段的首帧/尾帧引导。
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"
}使用本页通过共享的 CometAPI
/v1/videos 路由启动一个 Veo 任务。设置 model 时，请从模型页面选择当前可用的 Veo 别名。
选择请求模式
- 文本生成视频：不发送
input_reference文件 - 图片生成视频：发送一个
input_reference - 首帧和尾帧引导：按顺序发送两个
input_reference文件
任务流程
轮询共享视频端点
使用 Veo3 Retrieve 跟踪异步任务，直到其进入终态。
别名解析
Google 通过 Gemini 的长时间运行视频操作来说明 Veo，并使用诸如veo-3.1-generate-preview 之类的模型名称。CometAPI 保留共享的 /v1/videos 路由，并在请求时从模型页面解析当前可用的 Veo 别名。在 2026-03-12 的实际验证中，使用 veo3-fast 的请求被接受并返回了一个异步任务 id，而响应中的 model 被解析为提供方模型 id，而不是回显所提交的别名。授权
Bearer token authentication. Use your CometAPI key.
请求体
multipart/form-data
Text prompt for the video job.
示例:
"A paper kite floats above a field."
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"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
示例:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
⌘I
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"
}