跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
videos
/
generations
curl https://ai.kaiho.cc/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q3-pro",
    "prompt": "宇航员在月球表面行走，地球在远处升起",
    "resolution": "1080p"
  }'

{
  "code": "success",
  "data": "task-wave17409840000001884722"
}
该接口为异步执行，请求成功后会返回任务 ID。生成通常需要 1-3 分钟，生成结果在服务器保留 24 小时。
curl https://ai.kaiho.cc/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q3-pro",
    "prompt": "宇航员在月球表面行走，地球在远处升起",
    "resolution": "1080p"
  }'

{
  "code": "success",
  "data": "task-wave17409840000001884722"
}

​
认证方式

在请求头中加入 Authorization: Bearer YOUR_API_KEY。您可以从 API Key 页面 获取您的密钥。

​
请求参数

​
model
string
必填
模型 ID：vidu-q3-pro
​
prompt
string
视频生成的提示词。
​
image_urls
array
输入图片的 URL 列表。支持图生视频。
​
resolution
string
分辨率。可选值：540p, 720p, 1080p。
​
duration
integer
视频时长，支持 1-16 秒范围。

​
响应参数

​
code
string
响应状态码 * success - 请求成功，任务已提交
​
data
string
任务 ID，格式为 task-wave{timestamp}{userId}{random}，用于通过 查询任务状态 接口获取生成结果

​
使用示例

​
文本生成视频

{
  "model": "vidu-q3-pro",
  "prompt": "宇航员在月球表面行走，地球在远处升起",
  "resolution": "1080p"
}

​
首尾帧视频生成

{
  "model": "vidu-q3-pro",
  "image_urls": ["https://example.com/start.jpg", "https://example.com/end.jpg"],
  "prompt": "镜头平滑地从起景过渡到终景"
}

​
注意事项

  • 默认开启音频生成。
  • 视频生成为耗时操作，请妥善保存 data 字段返回的任务 ID。
  • 生成结果可通过 查询任务状态 链接查看。