Browse ModelsX AIX AI Grok Imagine Video Text To Video

X Ai Grok Imagine Video Text To Video

X Ai Grok Imagine Video Text To Video

Playground

Try it 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.

Features

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

ParameterRequiredDescription
promptYesText description of the video scene and motion
durationNoVideo length in seconds (default: 6)
aspect_ratioNoOutput ratio: 16:9, 9:16, etc.
resolutionNoOutput resolution: 720p (default), 480p

How to Use

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

Pricing

DurationCost
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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-video/text-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720p"
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text description of the desired video.
durationintegerNo66, 10Video duration in seconds.
aspect_ratiostringNo16:916:9, 1:1, 9:16Aspect ratio of the generated video.
resolutionstringNo720p720p, 480pResolution of the output video.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.