Omni 视频生成对接说明

覆盖文生、图生、首尾帧、多图参考和视频转视频，统一走异步任务。

API Base URLhttps://api2.cgapi.top/v1查看模型广场

适用场景

Omni 适合把文字、图片和短视频素材组合成一个视频任务。无水印版本可能多一个 processing 阶段，业务端应继续轮询到终态。

参考图单张不超过 8 MB，最多 5 张；V2V 最多 2 段视频，每段不超过 8 MB，输入分辨率不高于 1920x1080。

模型与公共参数

模型 ID	`omni-fast`、`omni-fast-no-water` `omni-fast-v2v`、`omni-fast-v2v-no-water`
Endpoint	`POST /v1/videos`
画幅	`aspect_ratio` 传 `16:9` 或 `9:16`。
时长	按模型合同传 `seconds` 或 `duration`。
图片字段	`image_url`、`first_image_url`、`last_image_url` 或 `images`。
视频字段	`video`、`video_url` 或 `videos`。

JSON 请求

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"model":"omni-fast","prompt":"晨雾中的山路，航拍镜头缓慢前进，电影质感。","aspect_ratio":"16:9","seconds":"10","image_url":"https://cdn.example.com/reference.jpg"}'

multipart 素材上传

本地图片或视频不要先拼成不可访问的临时路径。用 multipart 上传文件，并保留文本字段；服务端返回任务 ID 后再轮询。

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --form "model=omni-fast-v2v" \
  --form "prompt=转换为赛博朋克夜景，保留人物运动轨迹。" \
  --form "aspect_ratio=16:9" \
  --form "videos=@source.mp4"

轮询与下载

从创建响应读取 id 或 task_id。
请求 GET /v1/videos/{task_id}，处理 queued、in_progress、processing、completed 等状态。
完成后请求 GET /v1/videos/{task_id}/content，检查 video/mp4 或返回体中的视频 URL。

成功信号

创建成功返回任务 ID。
任务进入 completed，无水印模型的 processing 也结束。
下载端点返回可播放 MP4。
V2V 任务的源视频数量、大小和分辨率符合限制。

常见问题

400：检查画幅值、素材字段和大小限制。
任务一直 processing：保留任务 ID，延长轮询窗口，避免重复付费提交。
素材 URL 失败：确认 URL 不需要登录，且服务端可访问。
价格与分组：以模型广场和控制台消费记录为准。