跳轉到主要內容

​
概述

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_frame 或 image_url基於圖片生成影片
首尾幀first_frame + last_frame指定首尾畫面生成過渡影片
並非所有模型都支援全部模式，請查看各模型文件了解具體支援情況。