Grok

Grok Video API

Video APIHOT

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

Model Type:
Pricing

Lowest cost starts at $0.08/s

Selected model
Grok Imagine 1.5 Image to Video

480p: 16 credits/s - Image to Video - Output seconds × 16

720p: 28 credits/s - Image to Video - Output seconds × 28

USD estimates use $0.005/credit with the best annual plan. Final billing follows the selected Grok video variant and output settings.

New tasks appear here after you submit.
API Input

Core request fields

Use a predictable payload for prompts, image URLs, source task IDs, aspect ratio, and callback settings.

Request JSON
{
  "image_url": "https://v3b.fal.media/files/b/0a8b90e0/BFLE9VDlZqsryU-UA3BoD_image_004.png",
  "resolution": "720p",
  "prompt": "Medieval knight in ornate armor walking through a mystical forest, bioluminescent plants pulsing with light, ancient stone ruins overgrown with glowing vines, over-the-shoulder camera, dark fantasy aesthetic, volumetric fog and Lumen lighting",
  "duration": 6
}

Use Grok Imagine 1.5 Image to Video for generation

The playground, request sample, request fields, and pricing on this page follow the selected model type.

View detailed API docs

Open the full API documentation for endpoints, authentication, task polling, and payload details. /models/grok-imagine.md

promptstringText description of desired changes or motion in the video.
durationnumberVideo duration in seconds.
resolutionenumResolution of the output video. (480p, 720p, 1080p)
image_urlstringURL of the input image for video generation.
Capabilities

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.

Quick Start

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.

Use Cases

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.

Prompt-led social clips for TikTok, Reels, and Shorts
Animated product stills and campaign visuals
Rapid storyboard and concept video exploration
Video variants for ads, thumbnails, and landing pages
Upscaled versions of successful generated clips
Extended clips for iterative creative pipelines
Community Showcase

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.

View more
Production Notes

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.

FAQ

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.

Start building

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.

API-ready
workflow
4 modes
video tools
Task ID
follow-ups