Grok Video API
Video APIHOTGrok Video API gives teams an API-first way to use Grok Imagine video generation inside production workflows. It supports prompt-driven text-to-video, reference-based image-to-video, video upscaling, and video extension from one model family.
Use the playground to validate prompts, source images, task IDs, duration, aspect ratio, and payload behavior before connecting Grok video generation to your app, creative tool, or content pipeline.
Lowest cost starts at $0.008/s
480p: 1.6 credits/s - Text/Image to Video - Output seconds × 1.6
720p: 3 credits/s - Text/Image to Video - Output seconds × 3
USD estimates use $0.005/credit with the best annual plan. Final billing follows the selected Grok video variant and output settings.
Core request fields
Use a predictable payload for prompts, image URLs, source task IDs, aspect ratio, and callback settings.
{
"model": "grok-imagine-video-1-5-preview",
"input": {
"prompt": "A cinematic product reveal with smooth orbit camera movement",
"reference_image_urls": [
"https://example.com/product.png"
],
"reference_video_urls": [],
"reference_audio_urls": [],
"generate_audio": true,
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5
}
}Use Grok Imagine Video 1.5 Preview for generation
The playground, request sample, request fields, and pricing on this page follow the selected model type.
View detailed API docsOpen the full API documentation for endpoints, authentication, task polling, and payload details. /models/grok-imagine.md
promptstringPrompt for video generation. Maximum length: 4096 characters.image_urlsarrayUpload image files to be used as API input. Supported file types: image/jpeg, image/png, image/webp, image/jpg. Maximum file size: 20MB. Supports multi-file upload, up to 7 file.Only one is supported when the resolution is 1080p.aspect_ratioenumThe aspect ratio of the video. This parameter is invalid if it is a single image. (1:1, 16:9, 9:16, 3:2, 2:3, auto)resolutionenumResolution for video generation. (480p, 720p, 1080p)durationnumberVideo duration in seconds. Range: [1, 15]. Default: 8. Minimum: 1. Maximum: 15. Step: 1.nsfw_checkerbooleanDefaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.What Grok Video API adds to your video workflow
The page follows the same API-first structure as the reference: test the model, understand the fields, then move into integration.
Text-to-video generation
Turn detailed prompts into short-form video concepts for social posts, ads, product moments, and fast creative exploration.
Image-to-video motion
Animate source images while preserving the subject, composition, and visual direction that your team already approved.
Upscale and extend
Improve successful Grok clips with video upscaling, or continue an existing generation with an extension task.
API-ready payloads
Work with model IDs, prompts, image URLs, task IDs, aspect ratios, callbacks, and task polling in one integration path.
From Grok video test to production request
A compact path for teams that want to validate output quality before wiring Grok video generation into an app.
1. Choose a mode
Select text-to-video for prompt-only creation, image-to-video for source image animation, or a follow-up mode for upscale and extend.
2. Submit generation
Call the API with your account key, model ID, prompt, optional image URLs or source task ID, and callback URL.
3. Poll and reuse
Track the task until it succeeds, then reuse the output URL in your product, campaign workflow, or follow-up video task.
What you can create with Grok Video API
Use the API when your product needs repeatable Grok video output, not just one-off manual generations.
Successful Grok video generations from the community
Browse public Grok video outputs that finished successfully, then open any case to inspect the prompt, settings, and result.
Grok Imagine Image to Video
A realistic candid handheld smartphone video of two female friends sitting in the back seat of a moving taxi at night. The young woman on the right rests her head against her friend's shoulder, maintaining her original relaxed position. She looks directly into the camera with a calm, neutral expression, then slowly lowers her gaze slightly without moving her head much. She does not smile or blink. Her friend on the left remains mostly still. The car moves naturally through the city, with realistic blurred streetlights and passing buildings visible through the windows. Soft reflections from passing lights subtly move across the car interior. Very gentle natural vehicle vibrations and slight handheld camera movement. Preserve her exact original facial identity, eye shape, nose, lips, facial proportions, long dark hair, sunglasses on her head, black outfit, body proportions, and original car interior. No smiling, no blinking, no laughing, no speaking, no face morphing, no beauty filters,
Grok Imagine Image to Video
1 -5 seconds while this woman was chatting, two men came, one wearing a bottle green t-shirt and the other a black t-shirt while both of them said "let's go ma'am" 6-10 seconds the woman was confused, the two men hugged the woman's right and left arms and asked her to go
Grok Imagine Text to Video
video drama fruit fondant au chocolat business
Grok Imagine Image to Video
jalan sambil telfon dan bilang : iya sayang aku otw
Grok Imagine Image to Video
generate
Grok Imagine Image to Video
A very thin stream of light amber water begins pouring steadily and continuously from the center of the bottom edge of the frame onto the russian woman. The stream, less than five millimeters in diameter, flows in a slightly arched trajectory over the woman's face for nine seconds. The woman on the left speaks dejectedly and quietly: "Вова, ну что ты наделал. " The camera is static.
Built for real Grok video API workflows
Account-gated execution
Users sign in, submit jobs, and consume credits through the existing SdanceAI generation flow.
Reference and task inputs
Image-to-video accepts source image URLs, while upscale and extend workflows can continue from completed video task IDs.
Mode-aware iteration
Start with text or image generation, then move promising outputs into upscale or extension workflows when needed.
Grok Video API questions
What is Grok Video API best for?
It is best for repeatable short-form video generation, including prompt-led clips, animated source images, video variants, upscaled outputs, and extended creative sequences.
Which Grok video modes are available?
The current page exposes Grok Imagine Text to Video, Grok Imagine Image to Video, Grok Imagine Video Upscale, and Grok Imagine Video Extend.
What is the difference between Text to Video and Image to Video?
Text to Video starts from a prompt only. Image to Video uses one or more source images plus a prompt, which is better when you need subject or composition continuity.
When should I use upscale or extend?
Use upscale when you already have a successful Grok video and want a higher-quality version. Use extend when you want to continue a completed generation into a longer sequence.
Where can I test it before integrating?
Use the playground on this page to test prompts, image URLs, source task IDs, aspect ratios, callbacks, and API payload behavior before moving into production.
Does the API support callbacks?
Yes. The request schema includes callback settings where supported, so your service can receive task completion notifications.
Can I use Grok Video API for commercial workflows?
This page is configured for production video workflows. For commercial use, review your account plan, credit balance, model availability, and applicable content policy requirements.
Can I animate an existing product image?
Yes. Use the image-to-video mode with a source image URL and a prompt that describes the motion, camera behavior, and final visual direction.
How should I manage cost?
Start with quick prompt or image-to-video tests, then reserve upscale and extension tasks for clips that are already close to your target.
Can I inspect the actual API fields?
Yes. Select a Grok video mode on this page and the request JSON, field list, and pricing panel will update to match that model.
Turn Grok video into your production workflow
Open the generator, test a Grok video prompt or source image, then use the API docs when you are ready to wire it into production.