Sign in

v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB
Video

视频生成接口

基于文本提示/图片生成视频的接口，支持多种视频生成模型和参数配置。

post/videos/generations

Request body

modelstring required

视频模型

promptstring required

文本提示

negative_promptstring

反向提示词，用来描述不希望在视频中看到的内容，可以对视频进行限制，仅支持该字段模型生效

image_tailstring

用于视频尾帧的图片URL，仅支持该字段模型生效

imagesstring[]

参考图片URL

with_audioboolean

是否带音效，仅支持音效的模型生效

sizestring

视频尺寸，尺寸越大价格可能越高，不同平台支持的尺寸参数不同，请参考创建视频API设置

resolutionstring

视频分辨率，不同平台支持的分辨率参数不同，请参考创建视频API设置

aspect_ratiostring

视频宽高比，默认为16:9，仅支持该字段模型生效

qualitystring

视频质量，仅支持该字段模型生效，智谱清言支持 speed、quality 两个配置，可灵 AI 和 Google Veo3 支持 std、pro 两个配置，默认 std，kling-v3 开始支持 4k

durationinteger

视频时长(秒)，默认5秒(海螺默认6s）

fps24 | 30 | 60

视频帧率，仅支持该字段模型生效

watermarkboolean

是否添加AI生成水印，默认为false，仅支持该字段模型生效

asyncboolean

是否异步生成，默认false，即同步等待视频生成成功后返回生成结果，如果异步需要通过调用视频获取接口获取生成结果，推荐使用异步

retriesinteger

自动重试次数

Example request

{
  "model": "cogvideox-flash",
  "prompt": "彼得兔开小汽车，游走在马路上，脸上的表情充满开心喜悦",
  "size": "720x720",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "quality": "speed"
}

Response

成功响应

modelstring required

使用的视频模型

task_idstring uuid required

任务ID

task_status'pending' | 'running' | 'succeed' | 'failed' required

任务状态

Example response

{
  "model": "cogvideox-flash",
  "task_status": "running"
}