Turn a text prompt into a short video. Pick a model with the `model` field — Google Veo,
Learn more about Video from TextYour video shows up here
Pick a model — its real durations and resolutions load automatically.
Turn a text prompt into a short video. Pick a model with the model field — Google Veo, Seedance 2.0, Kling AI, Luma Ray, Runway Gen 4 or MiniMax Hailuo — then set resolution, duration and aspect ratio, and the video is generated for you.
You can also guide the result with reference media: send generation_type: "reference-to-video" with reference images, videos or audio clips (image_urls, video_urls, audio_urls) on Seedance, Kling O1 / 3.0 Omni and MiniMax H3 models.
Call List Video Models (media-video-models) for the live catalog: every model's provider, per-second price, supported modes, resolutions and durations.
This is an asynchronous job: you submit a request, receive a job ID right away, then poll until the video is ready.
Pricing is per second of generated video and depends on the model and the resolution — from 6.2 to 156 credits per second. The Pricing table lists every model; media-video-models always returns the live prices. The cheapest option is ray-3.2 at 540p (6.2 credits/s).
The model field picks the provider: Veo (veo-3.1-generate-001 and friends), Seedance (seedance-2-0, -fast, -mini), Kling (kling-v3, kling-v2-6, kling-v2-5-turbo, kling-3-0-turbo), Luma (ray-3.2), Runway (gen4.5) or MiniMax (hailuo-2.3, -fast, hailuo-02). Same request shape for all.
GET media-video-models (free) returns every model with its price, supported modes, resolutions, aspect ratios and durations — ideal for building a model picker.
Submit a job, get a job ID back immediately, and poll until the video is ready.
Veo: 512P/1080P/4K, 4-8s, 16:9 or 9:16. Seedance/Kling: up to 1080p (Kling 4k), 3-15s, plus 1:1. Luma: 5s or 10s. Runway: 2-10s and extra ratios (4:3, 3:4, 21:9). See media-video-models for the authoritative per-model list.
Each model has its own rate, and most models cost more at higher resolutions — from 6.2 to 156 credits per second. Billed for the generated video's duration when the job completes.
Marketing snippets
Short promo / ad / social video from a brief text prompt.
Animated product hero
Generate a short looping hero video for landing pages.
Storyboard / pre-vis
Quick visual pre-vis from a script line before commissioning real production.
Vertical (TikTok / Reels) content
Use aspect_ratio: 9:16 to generate portrait-format videos for short-form platforms.
input
prompt + model (required) + optional resolution, duration, aspect_ratio, generate_audio, seed
output
A job ID right away; once complete, result_data carries the video URL, duration and metadata.
id back immediately.status is completed.result_data.video_url.You're billed only when the job completes successfully. You can also configure a webhook to be notified instead of polling.
Call media-video-models for the live list. Snapshot:
| Model | Provider | Rate | Durations | Other modes |
|---|---|---|---|---|
veo-3.1-fast-generate-001 | Veo (Google) | 720P 20 · 1080P 24 credits/s | 4/6/8s | image-to-video, first-last-frame, extend |
veo-3.1-generate-001 | Veo (Google) | 80 credits/s | 4/6/8s | image-to-video, first-last-frame, extend |
veo-3.1-lite-generate-001 | Veo (Google) | 720P 10 · 1080P 16 credits/s | 4/6/8s | image-to-video, first-last-frame, extend |
seedance-2-0 | Seedance | 480p 14.1 · 720p 30 · 1080p 75 · 4k 156 credits/s | 4/5/6/8/10/15s | image-to-video, first-last-frame, reference-to-video |
seedance-2-0-fast | Seedance | 480p 10.8 · 720p 24 credits/s | 4/5/6/8/10/15s | image-to-video, first-last-frame, reference-to-video |
seedance-2-0-mini | Seedance | 480p 6.8 · 720p 15 credits/s | 4/5/6/8/10/15s | image-to-video, first-last-frame, reference-to-video |
seedance-2-5 | Seedance | 480p 20.7 · 720p 46 · 1080p 115 credits/s | 4-30s | image-to-video, first-last-frame, reference-to-video |
kling-v3 | Kling | 720p 16.5 · 1080p 22 · 4k 82.5 credits/s | 3/4/5/6/7/8/9/10/12/15s | image-to-video, first-last-frame |
kling-v3-omni | Kling | 720p 25.5 · 1080p 34 · 4k 85 credits/s | 3-15s | image-to-video, first-last-frame, reference-to-video |
kling-video-o1 | Kling | 720p 25.5 · 1080p 34 credits/s | 5/10s | image-to-video, first-last-frame, reference-to-video |
kling-v2-6 | Kling | 34 credits/s | 5/10s | image-to-video, first-last-frame |
kling-v2-5-turbo | Kling | 720p 8.4 · 1080p 14 credits/s | 5/10s | image-to-video, first-last-frame |
kling-3.0-turbo | Kling | 720p 22.4 · 1080p 28 credits/s | 3/4/5/6/7/8/9/10/12/15s | image-to-video |
ray-3.2 | Luma | 540p 6.2 · 720p 12.5 · 1080p 50 credits/s | 5/10s | image-to-video, first-last-frame, extend |
gen4.5 | Runway | 25 credits/s | 2-10s | image-to-video |
hailuo-2.3 | MiniMax | 768P 9.2 · 1080P 16 credits/s | 6/10s | image-to-video, first-last-frame |
hailuo-02 | MiniMax | 768P 9.2 · 1080P 16 credits/s | 6/10s | image-to-video, first-last-frame |
minimax-h3 | MiniMax | 768P 16 · 2K 26 credits/s | 4-15s | image-to-video, first-last-frame, reference-to-video |
minimax-h3-max | MiniMax | 480P 10 · 768P 16 credits/s | 5-15s | image-to-video, first-last-frame, reference-to-video |
Rules of thumb: veo-3.1-generate-001 for final quality with audio, hailuo-2.3 for the cheapest text-to-video loop, hailuo-2.3-fast / gen4_turbo for cheap image animation, ray-3.2 / kling-v3 as mid-range options.
Send "generation_type": "reference-to-video" together with a prompt and your reference media. The prompt says what should happen; the references say who and what it should look or sound like. Models that support it (live list: media-video-models?mode=reference-to-video):
| Model | Rate (720p) | Images | Videos | Audio | Reference video limits |
|---|---|---|---|---|---|
seedance-2-0 | 30 credits/s | 9 | 3 | 3 | 2-15 s each, 15 s in total, 200 MB |
seedance-2-0-fast | 24 credits/s | 9 | 3 | 3 | 2-15 s each, 15 s in total, 200 MB |
seedance-2-0-mini | 15 credits/s | 9 | 3 | 3 | 2-15 s each, 15 s in total, 200 MB |
seedance-2-5 | 46 credits/s | 30 | 10 | 10 | 2-30 s each, 30 s in total, 200 MB |
kling-video-o1 | 25.5 credits/s | 7 | 1 | — | 3-10 s, 200 MB; can keep the video's sound |
kling-v3-omni | 25.5 credits/s | 7 | 1 | — | 3-15 s, 200 MB; sound is removed |
minimax-h3 | 16 credits/s (768P) | 9 | 3 | 3 | 2-15 s each, 15 s in total, 50 MB |
minimax-h3-max | 16 credits/s (768P) | 9 | 3 | 3 | 2-15 s each, 15 s in total, 50 MB |
Reference files must be public URLs — use upload-media for local files. Higher resolutions cost more; media-video-models returns the multiplier per resolution.
To make a character copy the exact movement of a video, use Video Motion Control (media-video-motion-control) instead.
16:9 — landscape, default. Best for desktop, YouTube and TV.9:16 — portrait. Best for TikTok, Instagram Reels and Shorts.promptrequiredstringText description of the video to generate.
modelrequiredstringPicks the provider and model — use a model_id / call_as / alias from media-video-models. Veo: 'veo-3.1-generate-001' (default), 'veo-3.1-fast-generate-001', 'veo-3.1-lite-generate-001', 'veo-3.0-fast-generate-001' (aliases 'veo (Audio)' / 'veo fast (Audio)' still work). Seedance: 'seedance-2-0', 'seedance-2-0-fast', 'seedance-2-0-mini'. Kling: 'kling-v3', 'kling-v2-6', 'kling-v2-5-turbo', 'kling-3-0-turbo'. Luma: 'ray-3.2'. Runway: 'gen4.5'. MiniMax: 'hailuo-2.3', 'hailuo-2.3-fast' (image-only), 'hailuo-02'.
generation_typestring · default: text-to-videoThe generation process. 'text-to-video' (default) or 'reference-to-video' (prompt + reference media in image_urls / video_urls / audio_urls). Other values are served by their own gateway services: 'image-to-video' (media-video-from-image), 'first-last-frame' (media-video-first-last-frame), 'extend' (media-video-extend, Veo only), 'motion-control' (media-video-motion-control).
enum: text-to-video, reference-to-video
image_urlsarrayreference-to-video: reference images (characters, objects, style). Up to 9 on Seedance 2.0 and MiniMax H3, 30 on Seedance 2.5, 7 on Kling O1 / 3.0 Omni. Max 64 MB each.
video_urlsarrayreference-to-video: reference videos, mp4 or mov. Seedance 2.0 and MiniMax H3: up to 3 clips, 2-15 s each and 15 s in total. Seedance 2.5: up to 10 clips, 30 s in total. Kling O1: one clip of 3-10 s; Kling 3.0 Omni: one clip of 3-15 s. Max 200 MB each (50 MB on MiniMax).
audio_urlsarrayreference-to-video: reference audio clips, used as the sound of the result. Seedance and MiniMax H3 (up to 3, Seedance 2.5 up to 10). Not used by Kling models. Max 64 MB each.
keep_original_audioboolean · default: falsereference-to-video on Kling O1 only: keep the reference video's own sound. Kling 3.0 Omni always removes the sound when a reference video is sent.
resolutionstring · default: 1080P (Veo) / 720p (others)Output resolution — per model. Veo: '512P' / '1080P' / '4K'. Seedance & Luma: '720p' / '1080p'. Kling: '720p' / '1080p' / '4k' (720p = std mode, 1080p = pro mode). Runway: '720p' / '1080p' (Gen 4 Turbo: 720p only). See media-video-models.
durationstring · default: 4s (Veo) / 5s (others)Video duration as a string with the 's' suffix — allowed values per model. Veo: 4/6/8s. Seedance: 4/5/6/8/10/15s. Kling: 3-15s. Luma: 5s or 10s. Runway Gen 4.5: 2-10s (Gen 4 Turbo: 5s or 10s). See media-video-models.
aspect_ratiostring · default: 16:9Aspect ratio. Veo: '16:9' or '9:16'. Seedance/Kling/Luma also allow '1:1'. Runway additionally allows '4:3', '3:4', '21:9'.
generate_audiobooleanSeedance/Kling/Luma/Runway: generate a soundtrack with the video. Veo models always include generated audio.
seedintegerNon-Veo providers: seed for reproducible generations (-1 = random).
Per second of generated video, at the model's rate for the chosen resolution. You're billed once, when the job completes successfully. This table is a snapshot (2026-10-07); media-video-models always returns the live prices.
| Service | Unit | Price |
|---|---|---|
| Fast · Veo 3.1 Fast (veo-3.1-fast-generate-001) | second | 720P 20 · 1080P 24 credits/second |
| High quality · Veo 3.1 (veo-3.1-generate-001) | second | 80 credits/second |
| Economy · Veo 3.1 Lite (Preview) (veo-3.1-lite-generate-001) | second | 720P 10 · 1080P 16 credits/second |
| Seedance 2.0 (seedance-2-0) | second | 480p 14.1 · 720p 30 · 1080p 75 · 4k 156 credits/second |
| Seedance 2.0 Fast (seedance-2-0-fast) | second | 480p 10.8 · 720p 24 credits/second |
| Seedance 2.0 Mini (seedance-2-0-mini) | second | 480p 6.8 · 720p 15 credits/second |
| Seedance 2.5 (seedance-2-5) | second | 480p 20.7 · 720p 46 · 1080p 115 credits/second |
| Kling 3.0 (kling-v3) | second | 720p 16.5 · 1080p 22 · 4k 82.5 credits/second |
| Kling 3.0 Omni (kling-v3-omni) | second | 720p 25.5 · 1080p 34 · 4k 85 credits/second |
| Kling O1 (kling-video-o1) | second | 720p 25.5 · 1080p 34 credits/second |
| Kling 2.6 (kling-v2-6) | second | 34 credits/second |
| Kling 2.5 Turbo (kling-v2-5-turbo) | second | 720p 8.4 · 1080p 14 credits/second |
| Kling 3.0 Turbo (kling-3.0-turbo) | second | 720p 22.4 · 1080p 28 credits/second |
| Luma Ray 3.2 (ray-3.2) | second | 540p 6.2 · 720p 12.5 · 1080p 50 credits/second |
| Runway Gen 4.5 (gen4.5) | second | 25 credits/second |
| MiniMax Hailuo 2.3 (hailuo-2.3) | second | 768P 9.2 · 1080P 16 credits/second |
| MiniMax Hailuo 02 (Legacy) (hailuo-02) | second | 768P 9.2 · 1080P 16 credits/second |
| MiniMax H3 (minimax-h3) | second | 768P 16 · 2K 26 credits/second |
| MiniMax H3 Max (minimax-h3-max) | second | 480P 10 · 768P 16 credits/second |
| List Video Models | item | Free |
Examples: a 4s Veo 3.1 video at 1080P = 320 credits; a 5s Kling 3.0 video at 1080p = 110 credits; a 5s Seedance 2.0 Mini video at 720p = 75 credits; a 6s Hailuo 2.3 video at 768P = 55.2 credits.
Most models cost more at higher resolutions and less at lower ones; where the table shows one number, the model has a single rate.
If a job fails, it isn't billed — you're only charged for videos that complete successfully.
Video from Image
Animate an existing image into a short video instead of generating from text.
Video Motion Control
Make a character image perform the exact motion of a reference video.
Image Generation
Generate still images from text (faster, cheaper).
Dubbing
Add localized voice narration to an existing video.