平台能力
视频生成模型
视频生成能力，覆盖异步任务、参数、轮询、下载和生产安全。
视频生成能力，覆盖异步任务、参数、轮询、下载和生产安全。
视频生成通常是耗时较长的异步任务，需要创建任务、查询状态、获取结果并在有效期内保存文件。
典型调用流程
创建任务（prompt / 首帧图 / 参考图）
↓
异步生成（排队 → 处理中）
↓
查询任务状态
↓
下载结果并转存到自有存储创建任务
POST/v1/videos
/v1/videos/generations 和 /v1/video/generations 是同一异步提交处理器的别名。
{
"model": "<video-model-id>",
"prompt": "雨后的未来城市街道，镜头缓慢向前移动",
"duration": 5,
"aspect_ratio": "16:9",
"seed": 42
}查询与下载使用 GET /v1/videos/{video_id} 与 GET /v1/videos/{video_id}/content。
能力分类
| 能力 | 说明 |
|---|---|
| 文生视频 | 仅凭提示词生成视频。 |
| 图生视频 | 以首帧图驱动生成。 |
| 参考图生视频 | 以多张参考图控制主体与风格。 |
| 视频编辑 | 对已有视频做局部替换或风格重绘。 |
模型选择维度
模型目录中 capabilities 含 video 的条目即为可用的视频模型。选型时按以下维度判断：
| 维度 | 需要确认的内容 |
|---|---|
| 支持操作 | 文生视频、图生视频、参考图生视频或视频编辑。 |
| 时长档位 | 单条允许的时长范围与对应计费。 |
| 画面比例 | 支持的横屏、竖屏与方形比例。 |
| 分辨率 | 720p、1080p 或更高档位。 |
| 任务特性 | 平均排队时长、任务有效期、失败是否计费。 |
具体模型标识以模型目录为准，本文档不列举固定清单。
查询当前可用模型
curl "${BASE_URL}/v1/public/models" \
-H "Authorization: Bearer ${APIQIK_API_KEY}"返回中 capabilities 含 video 的条目即为可用的视频模型；分辨率档位与每秒价格以控制台模型详情为准。
参数说明
| 参数 | 用途 | 需要注意 |
|---|---|---|
model | 选择视频模型。 | 准确标识与版本策略。 |
prompt | 描述主体、动作、环境、镜头和风格。 | 最大长度与支持语言。 |
image | 可选首帧或参考图。 | 格式、尺寸、比例、URL 或上传方式。 |
duration | 目标时长。 | 允许值及对价格和耗时的影响。 |
aspect_ratio | 画面比例。 | 支持的横屏、竖屏与方形比例。 |
seed | 控制可重复性。 | 是否支持，以及相同种子是否保证一致。 |
异步状态
任务至少会经过 queued、running、succeeded、failed、cancelled 之一。轮询间隔、任务有效期、结果 URL 有效期以及失败是否计费，按具体模型与渠道确定。
生产注意事项
- 轮询采用退避策略，不要每秒高频查询所有任务。
- 结果 URL 可能临时有效，成功后尽快保存到业务自己的存储。
- 生成前校验内容政策、版权、肖像与用户授权。
- 记录任务 ID，支持取消、追踪、失败恢复和账单核对。