跳转到主要内容
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": "<string>",
  "image_tail": "<string>",
  "with_audio": false,
  "size": "720x720",
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "quality": "speed",
  "duration": 5,
  "fps": 30,
  "watermark": false,
  "async": true,
  "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,
    "revised_prompt": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}
你可以在模型广场筛选查看系统支持的所有视频模型列表。
不同AI平台的视频生成模型支持的视频尺寸不一样，具体支持的尺寸请参考下面的表格：
平台模型支持的尺寸
OpenAISora-1480x480、480x854、854x480、720x720、720x1280、1280x720、1080x1080、1080x1920、1920x1080， 不同尺寸不同时长视频生成价格不同
OpenAISora-2720x1280、1280x720、1024x1792、1792x1024， 不同尺寸不同时长视频生成价格不同
GoogleVeo系列无尺寸配置，支持宽高比：16:9（默认值）、9:16，参考图片仅支持 jpg/png 格式，Veo3支持生成音频。
智谱清言CogVideoX系列720x480、1024x1024、1280x960、960x1280、1920x1080、1080x1920、2048x1080、3840x216， 默认短边是1080，长边按比例缩放
可灵AIkling系列无尺寸配置，支持宽高比：16:9、9:16、1:1，默认值：16:9
豆包/即梦AISeedance系列无尺寸配置，支持分辨率：480p、720p、1080p，默认值：1080p， 支持宽高比：16:9、4:3、1:1、3:4、9:16、21:9，默认值：16:9，图生视频默认值：adaptive
通义万相Wanx系列无尺寸配置，支持分辨率：480p、720p、1080p，其中wanx2.1-t2v-plus、wanx2.1-i2v-plus、wanx2.1-kf2v-plus仅支持720p（默认值），wanx2.1-t2v-turbo、wanx2.1-i2v-turbo、wan2.2-i2v-flash支持480p、720p（默认值），wan2.2-t2v-plus、wan2.2-i2v-plus支持480p、1080p（默认值），并且文生视频通过size字段传递分辨率，图生视频通过resolution传递分辨率。
MiniMax海螺系列无尺寸配置，支持分辨率：512P、768P、1080P。
StabilityStable Video系列无尺寸配置，仅支持图生视频，因此对图片尺寸有要求，限定为以下几种尺寸（单位：像素）： 1024x576、576x1024、768x768，参考图片仅支持 jpg/png 格式。
视频模型 API 调用示例可以参考这里：生成视频。

​
请求/响应参数明细

Authorizations

​
Authorization
string
header
required

API认证token

Body

application/json
​
model
string
required

视频模型

Example:

"cogvideox-flash"

​
prompt
string
required

文本提示

Example:

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

​
negative_prompt
string

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

​
image

单张图片URL（可用于首帧图片）

​
image_tail
string

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

​
with_audio
boolean
default:false

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

​
size
string

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

Example:

"720x720"

​
resolution
string

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

Example:

"1080p"

​
aspect_ratio
string

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

Example:

"16:9"

​
quality
string

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

Example:

"speed"

​
duration
enum<integer>
default:5

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

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

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

Available options:
24,
30,
60
​
watermark
boolean
default:false

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

​
async
boolean
default:false

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

Example:

true

​
retries
integer
default:0

自动重试次数

Response

成功响应

​
model
string
required

使用的视频模型

Example:

"cogvideox-flash"

​
task_id
string<uuid>
required

任务ID

​
task_status
enum<string>
required

任务状态

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

"running"

​
video_result
object

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

​
error
object

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

⌘I