Grok Imagine Video Text to Video | Powerful Text-to-Video API

Grok Imagine Video Text-to-Video

Grok Imagine Video Text-to-Video is X-AI's text-to-video generation model that creates videos directly from text descriptions. Describe the scene, motion, and style you want — the model generates cinematic footage with realistic movement and atmosphere.

Why Choose This?

Pure text-driven generation Create videos from scratch using only text descriptions.
Flexible duration Generate videos of varying lengths based on your needs.
Multiple aspect ratios Support for 16:9, 9:16, and other common formats.
Resolution options Output in 480p or 720p based on your requirements.
Prompt Enhancer Built-in tool to automatically improve your video descriptions.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the video scene and motion
duration	No	Video length in seconds (default: 6)
aspect_ratio	No	Output ratio: 16:9, 9:16, etc.
resolution	No	Output resolution: 720p (default), 480p

How to Use

Write your prompt — describe the scene, motion, camera movement, and atmosphere in detail.
Set duration — choose how long the video should be.
Select aspect ratio — 16:9 for landscape, 9:16 for vertical content.
Select resolution — 720p for quality, 480p for faster processing.
Run — submit and download your video.

Pricing

Duration	Cost
Per second	$0.055

Billing Rules

Total cost = $0.055 × duration (in seconds)

Examples

5s video → $0.275
6s video → $0.33
10s video → $0.55

Best Use Cases

Social Media Content — Generate short-form videos for TikTok, Reels, and Stories.
Concept Visualization — Bring ideas to life without filming or stock footage.
Marketing & Ads — Create promotional video content from descriptions.
Storytelling — Generate narrative scenes for creative projects.
Rapid Prototyping — Test video concepts before full production.

Pro Tips

Use the Prompt Enhancer to refine your descriptions automatically.
Be specific about camera movement (handheld, dolly, pan, zoom) for dynamic footage.
Describe lighting, weather, and atmosphere for more realistic results.
Match aspect ratio to your target platform: 16:9 for YouTube, 9:16 for TikTok/Reels.
Include action details and timing for more controlled motion.

Notes

Only prompt is required; other parameters have defaults.
Ensure uploaded URLs are publicly accessible if referencing external content.
For best results, write detailed prompts with scene, motion, and style information.

Related Models

Grok Imagine Video Image-to-Video — Generate video from reference images.
Grok Imagine Video Edit — Edit existing videos with text instructions.
Grok Imagine Image Text-to-Image — Generate images from text prompts.

Grok Imagine Video Text To Video API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-video/text-to-video with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Grok Imagine Video Text To Video below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-video/text-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720p"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("x-ai/grok-imagine-video/text-to-video", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "duration": 6,
        "aspect_ratio": "16:9",
        "resolution": "720p"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "x-ai/grok-imagine-video/text-to-video",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720p"
}
)

print(output["outputs"][0])  # → URL of the generated output

Grok Imagine Video Text To Video API — Frequently asked questions

What is the Grok Imagine Video Text To Video API?

Grok Imagine Video Text To Video is a xAI model for video generation, exposed as a REST API on WaveSpeedAI. X-AI Grok Imagine Video generates videos from text descriptions using xAI's Grok Imagine Video model. Create high-quality videos with customizable duration, aspect ratio, and resolution. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Grok Imagine Video Text To Video API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/x-ai/x-ai-grok-imagine-video-text-to-video.

How much does Grok Imagine Video Text To Video cost per run?

Grok Imagine Video Text To Video starts at $0.050 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Grok Imagine Video Text To Video accept?

Key inputs: `prompt`, `aspect_ratio`, `resolution`, `duration`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/x-ai/x-ai-grok-imagine-video-text-to-video.

How long does Grok Imagine Video Text To Video take to generate?

Average end-to-end generation time on WaveSpeedAI is around 130 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Grok Imagine Video Text To Video outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (xAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README

Grok Imagine Video Text-to-Video

Why Choose This?

Parameters

How to Use

Pricing

Billing Rules

Examples

Best Use Cases

Pro Tips

Notes

Related Models

Grok Imagine Video Text To Video API — Quick start

Grok Imagine Video Text To Video API — Frequently asked questions