POST/v1/video/create

Veo 图生视频：上传起始图片

上传一张 PNG 或 JPEG 作为视频的起始画面，再用文字描述动作、镜头和声音。接口仍然是异步任务：提交后保存任务 ID，查询完成状态，再下载 MP4。

API Key application/json

上传一张 PNG 或 JPEG 作为视频的起始画面，再用文字描述动作、镜头和声音。接口仍然是异步任务：提交后保存任务 ID，查询完成状态，再下载 MP4。

这项功能能做什么

图生视频适合让产品图、角色设定图或风景图动起来。Google 原生 Veo 3.1 支持最多 3 张参考图，但青云 /v1/videos 当前适配只读取一张起始图。多参考图、首尾帧和视频延长不属于本入口的支持范围，请勿直接套用 Google 原生请求参数。

鉴权与调用

创建、查询、下载均使用青云 API Key：Authorization: Bearer YOUR_API_KEY。准备本地 PNG/JPEG，使用 multipart 的 input_reference 上传；或把图片编码为 data URL，放入 JSON 的 images[0]。提交到 POST https://top.qingyuntop.ai/v1/videos 后保存 id，再轮询查询并下载 MP4。

Request

请求

/v1/video/create

Body

必填

Bodyobject

imagesarray<string>

元素string

modelstring必填

orientationstring

可选值：portrait、landscape

promptstring必填

durationinteger

时长

可选值：10、15、25

character_urlstring

创建角色需要的视频链接，注意视频中一定不能出现真人，否则会失败

character_timestampsstring

视频角色出现的秒数范围，格式 `{start},{end}`, 注意 end-start 的范围 1-3秒

sizestring必填

可选值：large、small

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	-	application/json

请求示例application/json

curl -X POST https://top.qingyuntop.ai/v1/video/create \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "images": [],
  "model": "sora-2",
  "orientation": "portrait",
  "prompt": "make animate",
  "duration": 15,
  "character_url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
  "character_timestamps": "1,3",
  "size": "large"
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

图片能力边界

本接口只使用 images[0] 或 multipart input_reference 作为起始图片。
Google 原生 referenceImages 最多 3 张；在青云统一接口中增加 referenceImages、lastFrame 或 video 不会启用多参考图、首尾帧或视频延长。
提交多张 images 时，当前适配只读取第一项。
使用 1080p 或 4k 时保持 seconds: 8。