Video Generation API
The Video Generation API lets you create high-quality videos from a text prompt (text-to-video) or from a reference image (image-to-video) through one unified endpoint:model. Most models take an optional image_url for a first-frame image and run text-to-video when it is omitted. Multi-reference models (viduq3_turbo_reference, viduq4_preview_reference, grok_imagine_refs, grok_imagine_1_5_refs) take an image_urls array instead. Single-image endpoints — including grok_imagine and grok_imagine_1_5 — take a scalar image_url, and for both of them it is optional — the two fields are not interchangeable. See each model page for its exact parameters.
Available Models
Model values are not uniformly punctuated: Seedance and Kling use hyphens (
seedance-2-0, kling-3-0), while Vidu, Hailuo, Grok, PixVerse and Wan use underscores (viduq3_pro, hailuo_2_3, grok_imagine, pix_v6, wan22_spicy). Copy the value exactly as shown — anything else returns Unsupported model.Choosing a Vidu model
viduq3_pro and viduq3_turbo cover text-to-video, image-to-video and start-end frame generation — Turbo is roughly half the price, Pro has the higher fidelity.
Reference-image generation is a separate model, viduq3_turbo_reference, because Vidu prices it differently and enforces a 3-second minimum. The two are mutually exclusive: viduq3_turbo rejects image_urls, and viduq3_turbo_reference rejects image_url / image_end_url.
Vidu Q4 Preview is the newest generation, with output up to 4K. It comes as two models with the same price: viduq4_preview turns a first-frame image_url into a video (it has no text-to-video or start-end frame mode, so image_url is required), and viduq4_preview_reference takes 1-15 image_urls plus up to 3 optional ref_audios clips for voices and dialogue.
Feature Matrix — Wan & Kling
Feature support for the other families is listed on their own pages.Pricing
Every price below is given in tokens and USD, converted at $0.02/token (10 USD = 500 tokens). Tokens are what is actually deducted from your balance; the USD figure is the same price expressed in money. Seedance is charged per second of generated video:
Synchronized audio is included at no additional charge.
content_filter does not affect pricing.
Wan 2.2 has a fixed per-task cost:
Kling costs are charged per second of generated video:
Example: a 5-second
kling-2-5-turbo video at 720p costs 9.45 tokens (= $0.189).
Vidu costs are charged per second of generated video:
Example: an 8-second
viduq3_turbo video at 720p costs 22 tokens (= $0.44).
Vidu Q4 Preview (viduq4_preview and viduq4_preview_reference, same price):
Example: a 5-second
viduq4_preview video at 1080p costs 39 tokens (= $0.78).
Hailuo has a fixed cost per video, by resolution and duration:
1080P is only available at 6 seconds.
Grok Imagine costs are charged per second of generated video. All four endpoints share the same 480p and 720p rates; at 1080p, both Grok Imagine 1.5 endpoints cost twice their 720p rate:
Example: a 6-second
grok_imagine video at 720p costs 28.2 tokens (= 0.564).
An 8-second `grok_imagine_1_5` video at 720p costs 37.6 tokens (= 0.752).
An 8-second grok_imagine_1_5 video at 1080p costs 75.2 tokens (= $1.504).
Grok Imagine offers 1080p only on the single-image endpoint grok_imagine; grok_imagine_refs runs at 480p or 720p. Both Grok Imagine 1.5 endpoints offer 1080p with any supported number of reference images. 1080p videos take longer to finish than 480p or 720p.
PixVerse costs are charged per second of generated video. Native audio (sound: on) uses the higher rate:
Example: a 5-second
pix_v6 video at 720p costs 14.11 tokens silent (= 0.3762).
Gemini Omni Video is charged per generation by resolution and duration (720p and 1080p share the same price):
Check your balance with Get User Tokens.
How It Works
- Submit a task — call
POST /api/v1/videos/generationswith your model and prompt - Get the task id — the response returns an
img_uuid - Get the result — poll Get Job Detail with the
img_uuid, or pass acustom_callback_urlto receive status notifications automatically
