Skip to main content

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:
The request is dispatched by model. Most models take an optional image_url for a first-frame image and run text-to-video when it is omitted. Reference-image models (viduq3_turbo_reference, grok_imagine_1_5) take an image_urls array instead — 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.

Feature Matrix — Wan & Kling

Feature support for the other families is listed on their own pages.

Pricing

All token prices below convert to USD at $0.02/token (10 USD = 500 tokens). Seedance is charged in tokens 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 in tokens per second of generated video: Example: a 5-second kling-2-5-turbo video at 720p costs 9.45 tokens. Vidu costs are charged in tokens per second of generated video: Example: an 8-second viduq3_turbo video at 720p costs 22 tokens. Hailuo has a fixed cost per video, by resolution and duration: 1080P is only available at 6 seconds. Grok Imagine costs are charged in tokens per second of generated video: Example: a 6-second grok_imagine video at 720p costs 5.85 tokens. PixVerse costs are charged in tokens 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, or 18.81 tokens with audio. 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

  1. Submit a task — call POST /api/v1/videos/generations with your model and prompt
  2. Get the task id — the response returns an img_uuid
  3. Get the result — poll Get Job Detail with the img_uuid, or pass a custom_callback_url to receive status notifications automatically

Example

Response:
See the per-model pages for the full parameter reference: Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini, Wan 2.2, Kling 3.0, Kling 3.0 Turbo, Kling 2.5 Turbo, Vidu Q3 Pro, Vidu Q3 Turbo, Vidu Q3 Turbo Reference, Hailuo 2.3, Hailuo 2.3 Fast, Grok Imagine, Grok Imagine 1.5, PixVerse V6, Gemini Omni Video.