跳转到主要内容

概述

WaveAPI 支持多种视频生成模型,统一通过异步任务接口 /v1/tasks 调用。视频生成通常耗时较长,请使用轮询或 Webhook 回调获取结果。

请求端点

POST https://qingbo.dev/v1/tasks

通用请求参数

参数类型必填说明
modelstring模型名称
actionstring默认 "generate"
promptstring视频描述文本
durationinteger视频时长(秒)
aspect_ratiostring宽高比,如 "16:9"
first_framestring首帧图片 URL(图生视频)
last_framestring尾帧图片 URL(需配合 first_frame)
video_urlstring参考视频 URL
video_urlsarray多个参考视频 URL
image_urlstring参考图片 URL
image_urlsarray多张参考图片 URL
generate_audioboolean是否同时生成音频
watermarkboolean是否添加水印
callback_urlstring完成后的回调地址
extraobject模型特定的透传参数

响应格式

{
  "task_id": "task_xxx",
  "status": "completed",
  "result": {
    "videos": [
      {
        "url": "https://...",
        "expires_at": 1720000000
      }
    ]
  }
}

支持的模型

VEO3

Google 视频生成模型

Sora2

OpenAI 视频生成模型

Kling

快手可灵系列

更多模型

海螺、豆包、Vidu、万象 等

生成模式

大部分视频模型支持以下模式:
模式参数说明
文生视频prompt纯文本描述生成视频
图生视频prompt + first_frameimage_url基于图片生成视频
首尾帧first_frame + last_frame指定首尾画面生成过渡视频
并非所有模型都支持全部模式,请查看各模型文档了解具体支持情况。