POST
/
videos
/
generations
curl --request POST \
  --url https://geekai.co/api/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "cogvideox-flash",
  "prompt": "彼得兔开小汽车，游走在马路上，脸上的表情充满开心喜悦",
  "negative_prompt": "<string>",
  "image_url": "<string>",
  "async": false,
  "with_audio": false,
  "size": "1920x1080",
  "quality": "speed",
  "duration": 5,
  "fps": 30,
  "retries": 0
}'
{
  "model": "cogvideox-flash",
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_status": "running",
  "video_result": {
    "url": "<string>",
    "cover_image_url": "<string>",
    "duration": 123,
    "size": 123
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

你可以在模型广场筛选查看系统支持的所有视频模型列表。

不同AI平台的视频生成模型支持的视频尺寸不一样，具体支持的尺寸请参考下面的表格：

平台模型支持的尺寸
智谱清言CogVideoX系列

720x480、1024x1024、1280x960、960x1280、1920x1080、 1080x1920、2048x1080、3840x216，默认短边是1080，长边按比例缩放

可灵AIkling-v1系列

无尺寸配置，支持宽高比：16:9、9:16、1:1， 默认值：16:9

StabilityStable Video系列

无尺寸配置，仅支持图生视频，因此对图片尺寸有要求，限定为以下几种尺寸（单位：像素）： 1024x576、576x1024、768x768，参考图片仅支持 jpg/png 格式。

视频模型 API 调用示例可以参考这里：生成视频。

​
请求/响应参数明细

Authorizations

​
Authorization
string
header
required

JWT认证token

Body

application/json
​
model
string
required

视频模型

Example:

"cogvideox-flash"

​
prompt
string
required

文本提示

Example:

"彼得兔开小汽车，游走在马路上，脸上的表情充满开心喜悦"

​
negative_prompt
string

反向提示词，用来描述不希望在视频中看到的内容，可以对视频进行限制

​
image_url
string

用于生成视频的图片URL路径，需要可以公开访问，默认为空

​
async
boolean
default:false

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

Example:

false

​
with_audio
boolean
default:false

生成音效

Example:

false

​
size
enum<string>

视频尺寸

Available options:
720x480,
1024x1024,
1280x960,
960x1280,
1920x1080,
1080x1920,
2048x1080,
3840x2160
Example:

"1920x1080"

​
quality
string

视频质量，智谱清言支持 speed、quality 两个配置，可灵AI支持 std、pro 两个配置。

Example:

"speed"

​
duration
enum<integer>
default:5

视频时长(秒)，默认5秒。

Available options:
5,
10
​
fps
enum<integer>
default:30

视频帧率

Available options:
30,
60
​
retries
integer
default:0

自动重试次数

Example:

0

Response

200
application/json
成功响应
​
model
string
required

使用的视频模型

Example:

"cogvideox-flash"

​
task_id
string
required

任务ID

​
task_status
enum<string>
required

任务状态

Available options:
pending,
running,
success,
failed
Example:

"running"

​
video_result
object

视频生成结果(仅在同步模式且生成成功时返回)

​
error
object

错误信息(仅在生成失败时返回)