知梦视频 Veo / Omni 视频生成 API 对接文档

更新日期：2026-10-14（北京时间）。本文按知梦视频当前线上接口和模型广场价格编写，面向调用知梦视频 API 的开发者。模型 ID、请求字段、价格均以本站为准。

**最重要的区别：**本站 Veo/Omni 的对外 API 不接受 seconds、duration、resolution、aspect_ratio。画质和横竖屏由 model 与 size 决定；输出秒数目前不可通过 API 指定。把其他视频模型的请求体直接套用到这里会得到 400。

1. 接口地址与鉴权

推荐使用 HTTPS 域名：

用途	方法	地址
创建视频任务	`POST`	`https://movie.zmoapi.cn/v1/videos`
查询任务状态	`GET`	`https://movie.zmoapi.cn/v1/videos/{task_id}`
获取成片内容	`GET`	`https://movie.zmoapi.cn/v1/videos/{task_id}/content`

创建和查询使用知梦视频站内创建的 API 令牌：

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

YOUR_API_KEY 是占位符，请替换为你自己的令牌；不要把真实令牌放在浏览器前端、公开仓库或分享截图中。获取成片内容的 /content 接口同样需要鉴权。视频工作台使用网页登录会话；工作台的 /api/video-studio/* 接口与这里的 Token API 不是同一套请求格式。

接口是异步的：创建任务 → 保存本站返回的 task_id → 定时查询 → completed 后读取 content.url。创建接口返回成功，只表示任务已受理。

2. 模型能力与人民币售价

以下是当前线上聚合视频分组（倍率 1）的基础售价，单位为人民币元/条；六款均按请求次数计费，不按秒计费。

对外 `model` ID	画质	文生视频	首帧 1 张	首尾帧 2 张	普通参考图	当前基础售价
`veo-3.1-lite`	720p	支持	支持	支持	不支持	¥0.78/条
`veo-3.1-fast`	720p	支持	支持	支持	恰好 3 张	¥0.78/条
`veo-3.1`	720p	支持	支持	支持	不支持	¥0.78/条
`veo-3.1-fast-1080p`	1080p	支持	不支持	不支持	不支持	¥0.86/条
`veo-3.1-1080p`	1080p	支持	支持	支持	不支持	¥0.86/条
`omni-flash-video`	720p	支持	不按首帧模式调用	不按首尾帧模式调用	1–3 张	¥0.46/条

**注意公开模型名：**Omni Flash 在本站视频 API 中的 ID 是 omni-flash-video，请按此字符串调用。不要把显示名称或其他接口中的 omni-flash 直接当作本站视频模型 ID。

所有六款仅支持 16:9 横屏或 9:16 竖屏。同一个模型内，使用其支持的图片模式不会另加基础费用；例如 veo-3.1-fast 的三图参考仍按 ¥0.78/条计。账号若有专属分组倍率，实际费用按“上表基础价 × 账号适用倍率”计算，以账号页面的报价和消费记录为准。任务创建时可能先预扣额度，生成失败按系统结算规则退回。

秒数说明：Veo 请求里不能传秒数。工作台或内部目录里出现的“8 秒”是流程占位/展示信息，不代表 API 可控制或保证每条恰好 8 秒。Omni Flash 工作台显示“固定 8 秒”，对外 API 仍不提供秒数参数；请以实际成片为准。上表价格是每条价格，不随实际输出秒数线性变化。

3. 创建任务的 JSON 格式

顶层仅允许以下五个字段；多余字段会被拒绝。

字段	类型	必填	规则
`model`	字符串	是	上表中的一个公开模型 ID，区分大小写。
`prompt`	字符串	是	非空；最多 10,000 个字符，UTF-8 编码后最多 16 KiB。
`size`	字符串	是	见下表，精确匹配宽高写法。
`reference_images`	字符串数组	否	已上传到本站视频工作台存储的公开 HTTPS 图片 URL；顺序用于区分首尾帧。纯文生视频省略。
`generation_mode`	字符串	建议显式填写	`text`、`first_frame`、`first_last` 或 `reference`，按模型能力选择。

size 同时决定画质和横竖屏：

模型档位	16:9 横屏	9:16 竖屏
720p：`veo-3.1-lite`、`veo-3.1-fast`、`veo-3.1`、`omni-flash-video`	`1280x720`	`720x1280`
1080p：`veo-3.1-fast-1080p`、`veo-3.1-1080p`	`1920x1080`	`1080x1920`

不要发送 720p 作为 size，也不要额外发送 ratio、aspect_ratio、resolution、duration 或 seconds。例如 "seconds":8 不会被忽略，而是会使请求被拒绝。

`generation_mode` 与图片数量

模式	`reference_images`	适用情况
`text`	省略或空数组	所有六款的纯文生视频。
`first_frame`	恰好 1 张	除 `veo-3.1-fast-1080p`、`omni-flash-video` 外的四款 Veo。
`first_last`	恰好 2 张	同上；数组第一张是首帧，第二张是尾帧。
`reference`	`veo-3.1-fast` 恰好 3 张；`omni-flash-video` 为 1–3 张	多图参考或 Omni 图片参考。

不写 generation_mode 时，系统会按图片数量推断：0 张为 text，1 张为 first_frame，2 张及以上为 reference。因此首尾帧一定要显式写 first_last；omni-flash-video 即使只有 1 张参考图，也必须显式写 reference。建议所有请求都明确填写模式。

参考图片 URL 的要求

reference_images 是URL 字符串数组，不是对象数组，也不是 Base64、文件路径或 multipart 文件。每个 URL 最多 4096 字符，必须是本站已上传图片的公开 HTTPS 地址，例如本站图床的 /file/... 链接或当前工作台存储生成的图片链接。任意第三方外链，即使浏览器可打开，也不符合本站此接口的图片校验规则；带查询参数或片段的链接也不适用。

可以先在知梦视频工作台上传图片，取得返回的本站图片 URL，再将 URL 放入 API 请求。工作台上传接口 /api/video-studio/upload 需要网页登录会话，不能只用上面的 API 令牌代替网页登录。下面示例中的 EXAMPLE_*.jpg 是占位路径，正式调用前须替换为真实已上传文件。

4. 可直接改用的请求示例

以下均向知梦视频本站提交 JSON。将 YOUR_API_KEY 替换为自己的 API 令牌。示例中的图片 URL 只是格式占位，不是可用素材。

4.1 720p 纯文生视频：Veo 3.1 Lite

bash

curl -sS -X POST 'https://movie.zmoapi.cn/v1/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "veo-3.1-lite",
    "prompt": "清晨的海边，一只红色风筝在微风中升起，镜头缓慢跟随，画面自然连贯，无文字",
    "size": "1280x720",
    "generation_mode": "text"
  }'

当前基础费用：¥0.78/条。若需要竖屏，将 size 改为 720x1280。

4.2 720p 首帧图生视频：Veo 3.1

json

{
  "model": "veo-3.1",
  "prompt": "保持首帧中的人物和服装一致，让人物缓缓走向海边，镜头平稳推进",
  "size": "1280x720",
  "generation_mode": "first_frame",
  "reference_images": [
    "https://tc.juheai.club/file/EXAMPLE_FIRST_FRAME.jpg"
  ]
}

当前基础费用：¥0.78/条。

4.3 1080p 首尾帧过渡：Veo 3.1 1080p

json

{
  "model": "veo-3.1-1080p",
  "prompt": "让画面从室内首帧自然过渡到室外尾帧，保持主体外观一致，镜头运动平滑",
  "size": "1920x1080",
  "generation_mode": "first_last",
  "reference_images": [
    "https://tc.juheai.club/file/EXAMPLE_FIRST_FRAME.jpg",
    "https://tc.juheai.club/file/EXAMPLE_LAST_FRAME.jpg"
  ]
}

当前基础费用：¥0.86/条。尾帧不能单独提交；首尾两张图片必须按顺序排列。

4.4 720p 三图参考：Veo 3.1 Fast

json

{
  "model": "veo-3.1-fast",
  "prompt": "参考三张图片中的主体、场景与色调，让主体在街道中自然移动，镜头连贯，无文字",
  "size": "720x1280",
  "generation_mode": "reference",
  "reference_images": [
    "https://tc.juheai.club/file/EXAMPLE_REFERENCE_1.jpg",
    "https://tc.juheai.club/file/EXAMPLE_REFERENCE_2.jpg",
    "https://tc.juheai.club/file/EXAMPLE_REFERENCE_3.jpg"
  ]
}

当前基础费用：¥0.78/条。此模型的 reference 模式要求恰好 3 张，1 张应改用 first_frame，2 张首尾帧应改用 first_last。

4.5 1080p 纯文生视频：Veo 3.1 Fast 1080p

json

{
  "model": "veo-3.1-fast-1080p",
  "prompt": "城市夜景航拍，镜头平稳穿过楼宇与河岸，灯光反射真实，电影质感，无文字",
  "size": "1920x1080",
  "generation_mode": "text"
}

当前基础费用：¥0.86/条。这款 1080p Fast 仅支持文生视频，不要添加 reference_images。

4.6 Omni Flash：1–3 张普通参考图

json

{
  "model": "omni-flash-video",
  "prompt": "让参考图中的红色热气球缓缓飞过青山，保持热气球外形和场景风格一致",
  "size": "1280x720",
  "generation_mode": "reference",
  "reference_images": [
    "https://tc.juheai.club/file/EXAMPLE_BALLOON.jpg"
  ]
}

当前基础费用：¥0.46/条。即使只传 1 张图，也必须写 generation_mode: "reference"；Omni 不支持用 first_frame 或 first_last 表示图片输入。不需要图片时可改用 text 模式并省略 reference_images。

5. 提交响应、查询与取片

提交成功通常返回 HTTP 200，其中 id 和 task_id 是同一个本站公开任务 ID；请保存它。成功提交不保证最终生成成功。

json

{
  "id": "task_xxxxxxxxx",
  "task_id": "task_xxxxxxxxx",
  "status": "queued"
}

建议每隔约 10–20 秒查询一次，不要每秒刷接口：

bash

curl -sS \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://movie.zmoapi.cn/v1/videos/task_xxxxxxxxx'

`status`	含义	客户端处理
`queued`	已受理、排队中	等待后继续查询。
`in_progress`	生成中，或正在处理/转存成片	等待后继续查询。
`completed`	成片已可用	读取 `content.url` 并及时保存。
`failed`	任务失败	停止轮询，查看消费记录；已预扣费用按失败结算规则退回。

progress 是进度提示值，不等于精确渲染百分比；以 status 判断是否完成。completed 时的典型响应如下：

json

{
  "id": "task_xxxxxxxxx",
  "task_id": "task_xxxxxxxxx",
  "model": "veo-3.1",
  "status": "completed",
  "progress": 100,
  "content": {
    "url": "https://tc.juheai.club/file/EXAMPLE_RESULT.mp4"
  },
  "result_url": "https://tc.juheai.club/file/EXAMPLE_RESULT.mp4",
  "video_url": "https://tc.juheai.club/file/EXAMPLE_RESULT.mp4",
  "output": ["https://tc.juheai.club/file/EXAMPLE_RESULT.mp4"]
}

结果链接指向知梦视频自己的图床。优先读取 content.url；result_url、video_url 等为兼容字段。也可通过带 Bearer 令牌的 GET /v1/videos/{task_id}/content 获取内容。请在任务完成后及时保存需要的成片，不要把结果地址当作永久存档。视频工作台对这些模型的预览/代理下载窗口通常为 1 小时、代理下载最多 3 次；这项工作台规则不等同于承诺 API 图床直链恰好 1 小时失效。

6. 错误处理与常见问题

错误请求会返回相应 HTTP 状态及类似 {"code":"...","message":"...","data":null} 的 JSON；message 用于说明原因。不要按 OpenAI 的 { "error": {...} } 结构解析此类任务错误。

现象	常见原因	处理方式
`400`，不支持的字段	传了 `seconds`、`duration`、`aspect_ratio`、`resolution` 等	只保留本文列出的五个顶层字段，使用 `size`。
`400`，尺寸错误	720p 模型用了 1080p 尺寸，或传了 `720p` 文本	按模型档位填写精确的 `宽x高`。
`400`，图片/模式不匹配	两张图未写 `first_last`、Omni 一张图未写 `reference`、Fast 多参考不是三张等	对照模式表显式填写 `generation_mode`。
`400`，图片 URL 被拒绝	图片不在本站已上传的存储域名下，或 URL 带查询参数	先经工作台上传，使用返回的公开 HTTPS 图片文件 URL。
`401` / `403`	令牌无效、账号无权限，或模型/分组不可用	核对本站令牌、账户分组及模型权限。
`429`	当前分组或服务繁忙	稍后重试，使用退避策略，避免并发重试风暴。
`5xx` / `504`	服务或网络等待超时，不能仅凭这个状态认定未建任务	若已有 `task_id`，先查询任务；若没有，先核对消费/任务记录再决定是否重提，避免重复生成。

接入前自检

model 是否为上表中的公开 ID，尤其 Omni 使用 omni-flash-video。
size 是否符合该模型档位与横竖屏；API 没有可传的秒数字段。
图生视频的图片是否为本站已上传、可直接公开访问的 HTTPS 文件链接。
generation_mode 是否与图片数量、模型能力一致，首尾帧是否按顺序放入数组。
创建后是否保存了本站返回的 task_id，并使用它轮询到 completed 或 failed。
实际扣费是否以账号分组报价与消费记录核对；生成失败时是否已按系统规则退款。

本文价格和能力依据 2026-10-14 的知梦视频线上配置。后续如模型配置或价格调整，请以知梦视频模型广场、工作台和实际消费记录为准。

知梦视频 Veo / Omni 视频生成 API 对接文档 ​

1. 接口地址与鉴权 ​

2. 模型能力与人民币售价 ​

3. 创建任务的 JSON 格式 ​

generation_mode 与图片数量 ​

参考图片 URL 的要求 ​

4. 可直接改用的请求示例 ​

4.1 720p 纯文生视频：Veo 3.1 Lite ​

4.2 720p 首帧图生视频：Veo 3.1 ​

4.3 1080p 首尾帧过渡：Veo 3.1 1080p ​

4.4 720p 三图参考：Veo 3.1 Fast ​

4.5 1080p 纯文生视频：Veo 3.1 Fast 1080p ​

4.6 Omni Flash：1–3 张普通参考图 ​

5. 提交响应、查询与取片 ​

6. 错误处理与常见问题 ​

接入前自检 ​

在线调试与相关页面 ​

知梦视频 Veo / Omni 视频生成 API 对接文档

1. 接口地址与鉴权

2. 模型能力与人民币售价

3. 创建任务的 JSON 格式

`generation_mode` 与图片数量

参考图片 URL 的要求

4. 可直接改用的请求示例

4.1 720p 纯文生视频：Veo 3.1 Lite

4.2 720p 首帧图生视频：Veo 3.1

4.3 1080p 首尾帧过渡：Veo 3.1 1080p

4.4 720p 三图参考：Veo 3.1 Fast

4.5 1080p 纯文生视频：Veo 3.1 Fast 1080p

4.6 Omni Flash：1–3 张普通参考图

5. 提交响应、查询与取片

6. 错误处理与常见问题

接入前自检

在线调试与相关页面