跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
videos
/
generations
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "veo3.1-quality",
    "prompt": "海豚在蔚蓝的海洋中跃出水面",
    "aspect_ratio": "16:9",
    "resolution": "1080p"
}'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
本接口采用异步模式。提交成功后，接口会返回一个任务 ID。您需要使用该 ID 调用 查询任务状态 接口获取最终生成结果。视频链接有效期为 24 小时，请及时下载。
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "veo3.1-quality",
    "prompt": "海豚在蔚蓝的海洋中跃出水面",
    "aspect_ratio": "16:9",
    "resolution": "1080p"
}'

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

​
认证方式

在请求头中加入 Authorization: Bearer YOUR_API_KEY 进行身份验证。您可以在 令牌管理 页面获取您的 API 密钥。

​
请求参数

​
model
string
必填
可选值：veo3.1-fast（快速生成）, veo3.1-quality（高画质）
​
prompt
string
必填
视频生成的文本描述。例如：“海豚在蔚蓝的海洋中跃出水面”
​
aspect_ratio
string
默认值:"16:9"
视频宽高比，支持 16:9 和 9:16。
​
duration
number
默认值:"8"
固定为 8 秒。
​
image_urls
array
支持最多 3 张图片 URL。用于首尾帧模式或参考图模式。
​
generation_type
string
默认值:"frame"
生成模式：frame（首尾帧模式）, reference（参考图模式）。注意：veo3.1-quality 不支持 reference 模式。
​
resolution
string
默认值:"720p"
分辨率，可选值：720p, 1080p, 4k。
​
enable_gif
boolean
默认值:"false"
是否生成 GIF 动图。注意：开启后不能选择 1080p 或 4k 分辨率。

​
响应参数

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

​
使用示例

​
文生视频 (高画质)

{
  "model": "veo3.1-quality",
  "prompt": "海豚在蔚蓝的海洋中跃出水面",
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

​
首尾帧模式 (快速)

{
  "model": "veo3.1-fast",
  "prompt": "一个人在草地上行走",
  "image_urls": ["https://example.com/start.jpg", "https://example.com/end.jpg"],
  "generation_type": "frame"
}

​
注意事项

  • 接口为异步处理，返回任务 ID 后请通过查询接口获取结果。
  • 视频链接有效期为 24 小时，过期后将无法访问，请及时转存。
  • veo3.1-quality 模式下暂不支持参考图模式。
  • enable_gif 与高分辨率（1080p/4k）不可同时使用。