Video Generation Overview

QWave API supports many video generation models, all called through the unified async task endpoint /v1/tasks. Video generation typically takes from 10 seconds up to several minutes; after submission you receive a task_id, and you fetch the result via polling or a webhook callback.

Request Endpoint

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

For the full async flow see Task System — Submit → Status → Result + optional webhook.

Supported Models

Veo Series

Google Veo 3.1 — official direct (Fast / Quality) + reverse-engineered (Lite / Quality)

Seedance Series

ByteDance Seedance — 1.0 Pro / 1.5 Pro / 2.0 (with Face / Fast variants)

Kling Series

Kuaishou Kling — v2.6 / v3 / v3-Omni / Video O1

Hailuo Series

MiniMax Hailuo — 2.3 / 2.3 Fast, 15 camera-movement directives

Vidu Series

Shengshu Vidu Q3 — Pro / Mix / Q3 / Turbo

Wan Series

Alibaba Tongyi Wanxiang — 2.7 VideoEdit (video editing / style transfer)

Skyreels

Kunlun Wanwei SkyReels V4 — Fast / Standard, multimodal reference

HappyHorse

Alibaba Cloud Bailian HappyHorse — single model auto-routes T2V/I2V/R2V/EDIT

Grok Imagine Video

xAI Grok Imagine 1.0 Video — 6-30 seconds, 5 aspect ratios

Common Parameters (shared across the series)

Each model’s actual supported range differs — see the individual vendor docs.

string

required

Model ID (group_name); pick from the vendor docs above

string

default:"generate"

Operation type; valid values depend on the model. Common values:

generate — text-to-video (T2V)
image2video — image-to-video (I2V)
first_last_frame — first/last frame
reference / reference_video — reference-to-video (R2V)
edit / video_edit / style_transfer — video editing
video_continuation / extend — video continuation

string

Video description text. Required for T2V; optional as guidance for other modes

integer

Video duration in seconds; range depends on the model

string

Frame aspect ratio, e.g. 16:9 / 9:16 / 1:1

string

Output resolution, e.g. 720p / 1080p / 4K

string[]

Array of reference image URLs (used for I2V / R2V)

string

First-frame image URL (used for first/last-frame mode)

string

Last-frame image URL; must be paired with first_frame_image

string[]

Array of reference video URLs — a single element is sufficient (used for video continuation / R2V video reference / video editing)

string[]

Array of reference audio URLs — a single element is sufficient (used for driving audio / custom voiceover)

string

Webhook callback URL, invoked when the task reaches a terminal state. See Task System

Submit Response Example

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo3.1-quality-official",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

After receiving task_id, poll GET /v1/tasks/{task_id} until status = completed, then read the video URL.

Mode Quick Reference

Mode	Trigger Fields	Typical Vendors
Text-to-video (T2V)	`prompt` only	All vendors that support the generate action
Image-to-video (I2V)	`+ first_frame_image` or `image_urls` (single image)	Seedance / Kling / Hailuo / Vidu Pro / Wan / Veo / Sky / Grok
First/last frame	`first_frame_image + last_frame_image`	Seedance Pro Quality / 1.5 / 2.0 / Kling / Veo / Vidu Pro / Sky
Reference-to-video (R2V)	`image_urls` (multiple, 1-9 images)	Seedance / Kling Omni / Vidu / Sky / HappyHorse
Video reference (R2V video)	`+ video_urls` (reference video)	Seedance 2.0 / Kling Omni / Sky / Wan
Video continuation	`video_urls` (single clip)	Wan (other tiers not yet available) / Sky
Video editing (EDIT)	`video_urls + prompt` (optionally `image_urls` as style reference)	Wan VideoEdit / HappyHorse / Sky
Audio reference	`+ audio_urls`	HappyHorse / Wan / Sky / Seedance 2.0

Not every model supports every mode — check each vendor’s doc for the actual supported action list and field range. The backend validates whether request fields fall within the vendor’s declared capabilities and returns an error if they do not.

Field Naming Conventions

Media references are always plural — always image_urls / video_urls / audio_urls; even a single video uses a one-element array ["one.mp4"]
Frame ratio is unified as aspect_ratio — vendor-internal size / ratio etc. are implementation details and not exposed
Resolution is unified as resolution — vendor-internal mode / quality etc. are implementation details
First/last-frame fields carry the _image suffix — first_frame_image / last_frame_image (emphasizing the image resource)

Task System Reference — task state machine / polling cadence / webhook
Request and Response Format — common error codes / headers / rate limits
Authentication — API key application and usage
Model List — full model list query endpoint

Text Generation

Image Generation