视频接口

概述

视频接口（Video API）以 任务式 方式提交视频生成请求：与图片接口共用同一个提交端点 POST /api/generate/submit，区别只在 model 字段与 input 字段（视频额外接受 duration / seconds）。提交后立刻返回 task_id，再用 GET /api/generate/status/{task_id} 轮询直到 status=finished。

鉴权

使用与 AI 模型接口一致的 Bearer Token：Authorization: Bearer sk-xxxxxx。

共用请求骨架

{
  "model": "sora-2 | sora-2-pro | veo-3.0-generate-001 | veo-3.1-generate-preview | ...",
  "input": {
    "prompt": "视频描述",
    "size": "WxH 像素，例如 1280x720 / 1920x1080 / 720x1280",
    "duration": 4,
    "seconds": "4",
    "image": "首帧参考图 URL（可选）",
    "images": ["首帧参考图 URL 列表（可选）"],
    "metadata": { /* 模型专属参数 */ }
  }
}

只有 prompt / size / image / images / duration / seconds 允许出现在 input 顶层；任何其它字段（例如 aspectRatio、resolution、negativePrompt）必须放进 input.metadata，否则会被 400 拒绝。

file_type 当前固定为 image

完成态响应 data.files[].file_type 当前实现固定返回 "image"，与媒体类型无关。判断是否视频请根据 file_url 后缀或调用方上下文。

概述

共用请求骨架

模型

sora-2

veo-3

目录