Skip to main content

快速上手

  • 重大变更(2025-12-10):generation_type → type;枚举改为 text-to-video / image-to-video / reference-to-video。
  • 品牌:Wizzx(第三方 API 聚合),统一使用 Authorization: Bearer <your_api_key>.
  • 提交生成:POST /api/v1/task/submit/veo3,异步返回 task_id。
  • 轮询状态:POST /api/v1/task/status,传入 task_id 获取结果或错误。
  • 默认模型 veo3_fast、分辨率 720p、16:9 画幅;也可选择成本更低的 veo3_lite,或画质最高的 veo3_quality。

认证

所有请求需携带:
Wizzx 网关会校验并注入身份,无需额外参数。

提交任务

接口:POST /api/v1/task/submit/veo3,Content-Type: application/json

必填参数

可选参数

type 字段规则

type 始终必填。reference-to-video 必须使用 duration=8,且模型为 veo3_fast 或 veo3_lite。veo3_quality 仅支持 6 或 8 秒,传 4 秒会返回 HTTP 422。

请求示例(Text2Video)

请求示例(Image2Video,首尾帧)

请求示例(Veo 3.1 Quality 文生视频)

请求示例(Reference2Video)

成功响应示例:

任务查询

接口:POST /api/v1/task/status 请求体:
响应示例:
客户端可见状态:PENDING、QUEUED、PROCESSING、REVIEW_REQUIRED、SUCCEEDED、FAILED。

计费

Veo 3.1 由 model 与 resolution 选择每个视频的固定扣费;时长不影响价格(Fast 与 Lite 支持 4、6、8 秒,Quality 支持 6、8 秒)。 提交前通过 /pricing 获取当前档位。 每个视频按模型档位与分辨率固定计费,1000 积分 = 1 美元。

常见问题

  • generation_type 字段去哪了? 统一改为 type,枚举改为小写连字符格式。
  • 需要回调 URL 吗? 不需要,直接轮询 task/status。
  • 如何复现结果? 传 seeds(10000-99999)。
  • 非英文提示词会怎样? 如需上游翻译,应显式传入 enable_translation=true。
  • image-to-video 下 1 张 vs 2 张图? 1 张作为首帧参考,2 张为首帧+尾帧,系统生成过渡。
  • 时长会乘算 Veo 积分吗? 不会。Veo 按每个视频固定计费,模型档位与分辨率决定扣费。

资料来源