VEO Omni Flash Video Edit - ZPIKA API Docs

编辑前，请先检查参考视频、图片和提示词 参考视频中的人脸、标识、影视画面和版权音频也会参与审查。遇到 didn't pass content review 或 PUBLIC_ERROR_AUDIO_FILTERED 时，应修改内容后再提交。

附加参考图要同步避开真人正脸、未成年人和受保护 IP，尽量使用虚构主体、侧背远景或非写实风格。

认证方式

所有请求都需要在请求头中携带 API Key：

Authorization: Bearer api-key

提交任务

向视频任务端点发送 JSON 请求，其中 video_url 指向唯一的参考视频。

curl -X POST https://aivideo.zpika.com/v1/videos \
  -H "Authorization: Bearer api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-omni-flash-video-edit",
    "prompt": "make the reference video brighter and more cinematic",
    "duration": 10,
    "aspect_ratio": "16:9",
    "video_url": "https://your-cdn.com/reference-video.mp4",
    "Ingredients_images": [
      "https://your-cdn.com/product.jpg"
    ]
  }'

请求参数

字段	说明
`model`	固定为 `veo-omni-flash-video-edit`
`video_url`	必填，只支持 1 个参考视频地址
`Ingredients_images`	可选，参考图片 URL 数组
`duration`	固定为 `10`
`aspect_ratio`	支持 `16:9` / `9:16`，默认横屏

查询任务

使用提交任务后获得的任务 ID 轮询任务状态。

curl https://aivideo.zpika.com/v1/videos/8c7e4b0e6f3b4b0a9e0a0d8f4f0c1234 \
  -H "Authorization: Bearer api-key"

查询返回示例

处理中

{
  "id": "8c7e4b0e6f3b4b0a9e0a0d8f4f0c1234",
  "task_id": "8c7e4b0e6f3b4b0a9e0a0d8f4f0c1234",
  "object": "video",
  "created_at": 1714200000000,
  "status": "in_progress",
  "state": "in_progress",
  "task_status": "in_progress",
  "progress": 45,
  "model": "veo-omni-flash-video-edit",
  "video_url": null,
  "metadata": {
    "result_urls": []
  },
  "seconds": "10",
  "duration": 10,
  "aspect_ratio": "16:9",
  "success": false,
  "final": false
}

已完成

{
  "id": "8c7e4b0e6f3b4b0a9e0a0d8f4f0c1234",
  "task_id": "8c7e4b0e6f3b4b0a9e0a0d8f4f0c1234",
  "object": "video",
  "created_at": 1714200000000,
  "status": "completed",
  "state": "completed",
  "task_status": "completed",
  "progress": 100,
  "model": "veo-omni-flash-video-edit",
  "video_url": "https://aivideo.zpika.com/generated/video.mp4",
  "url": "https://aivideo.zpika.com/generated/video.mp4",
  "metadata": {
    "result_urls": ["https://aivideo.zpika.com/generated/video.mp4"]
  },
  "seconds": "10",
  "duration": 10,
  "aspect_ratio": "16:9",
  "success": true,
  "final": true,
  "completed_at": 1714200180000
}

查询返回字段

字段	说明
`id` / `task_id`	任务 ID，用于继续查询
`status` / `state` / `task_status`	任务状态，三者值一致，便于兼容不同接入方式
`progress`	任务进度，范围为 0-100
`video_url`	视频任务完成后的主结果地址
`url`	完成后的通用结果地址，视频任务中等同于 `video_url`
`metadata.result_urls`	结果地址数组，通常读取第一项即可
`seconds` / `duration`	任务时长，来自提交参数
`aspect_ratio`	画面比例，来自提交参数
`success`	`status` 为 `completed` 时为 `true`
`final`	`completed` 或 `failed` 时为 `true`
`error.message`	失败原因，仅失败时返回

状态说明

status	含义	处理方式
queued	排队中	继续轮询
in_progress	生成中	继续轮询
completed	已完成	读取 `video_url`、`url` 或 `metadata.result_urls`
failed	失败	查看 `error.message`