视频生成
提交视频生成任务，查询处理状态并读取生成结果。
概述
AGTCloud 提供多种视频生成模型和调用协议。视频请求通常先创建任务，再使用任务标识查询状态并读取结果。
支持的任务类型
| 类型 | 说明 | 主要输入 |
|---|---|---|
| 文生视频 | 根据文字描述生成视频 | Prompt |
| 图生视频 | 让静态图片产生运动 | Prompt、图片 |
| 参考素材生成 | 根据模型支持的图片或视频素材生成内容 | Prompt、参考素材 |
| 模型专属扩展 | 使用首尾帧、运镜或其他专属能力 | 以对应模型和协议为准 |
API 接入
Base URL
https://api.agtcloud.cn/v1文生视频
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "一列火车穿过雨后的山谷，镜头缓慢向前推进"
}'图生视频
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "保持主体外观，让画面中的人物缓慢走向镜头",
"image": "https://example.com/input.jpg"
}'创建成功后，保存响应中的 Task ID，再使用同一协议查询任务。
查询任务
curl 'https://api.agtcloud.cn/v1/video/generations/TASK_ID' \
-H 'Authorization: Bearer your-api-key'选择调用协议
| 协议 | 创建入口 | 后续处理 |
|---|---|---|
| Platform Video Generations | POST /v1/video/generations | 使用 Task ID 查询结果 |
| OpenAI Videos | POST /v1/videos | 使用 Video ID 查询并下载内容 |
| 厂商专用协议 | 以对应 Reference 为准 | 使用该协议定义的任务标识和状态 |
同一次任务应始终使用同一协议的创建、查询和下载路径。