4Z API

创建视频生成任务

接口: POST https://4zapi.com/v1/video/create

统一视频创建入口(VEO relay · POST /v1/video/create)。支持 VEO / Sora-2 / Grok-Video 等,通过 model 字段区分。 Omni-Flash 模型参数与示例见 relay/omni(共用此物理路由)。 提交后返回 id,通过 GET /v1/video/query 轮询。

请求体 (application/json)

  • model (string, 必填): 模型名称 ["veo3", "veo3-fast", "veo3-pro", "sora-2", "grok-imagine-video-1.5"]
  • prompt (string, 必填): 视频内容描述
  • aspect_ratio (string): 宽高比(VEO 系列) ["16:9", "9:16", "1:1"]
  • duration: 视频时长(秒)
  • enable_upsample (boolean): 是否启用上采样(VEO)
  • enhance_prompt (boolean): 是否自动优化提示词(VEO)
  • images (array<string>): 参考图片 URL 列表(图生视频)
  • orientation (string): 方向(Sora-2) ["portrait", "landscape"]
  • seconds: 时长兼容字段
  • size (string): 清晰度(Sora-2) ["large", "small"]
  • type: Omni 系列任务类型
  • watermark (boolean): 是否添加水印;false=不添加

请求示例

{
  "aspect_ratio": "16:9",
  "enhance_prompt": true,
  "model": "veo3",
  "prompt": "A majestic eagle soaring over mountains at sunset"
}