ToAPIs
home

Quick Answer

  • Grok Video 1.5 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Key Parameters

  • model | string | required | grok-video-1.5 | - | Model identifier. Use the fixed value `grok-video-1.5`.
  • prompt | string | required | - | - | Main instruction describing the subject, action, scene, and style.
  • aspect_ratio | string | optional | 16:9 | 1:1 | 16:9 | 9:16 | 3:2 | 2:3 | Video aspect ratio. Defaults to `16:9`; supports `1:1 | 16:9 | 9:16 | 3:2 | 2:3`.
  • duration | integer | optional | 10 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Output duration in seconds. Defaults to `10`; supports `1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`.
  • resolution | string | optional | 720p | 480p | 720p | Output resolution. Defaults to `720p`; supports `480p | 720p`.

Common Errors

  • 400 invalid_request_error: trigger=Request payload misses required fields or has invalid field types.; fix=Validate model, mode, and input schema before request.; retry=Retry only after fixing payload; avoid blind retries.
  • 401 authentication_error: trigger=Missing Authorization header or invalid API key.; fix=Verify Bearer token format and API key scope.; retry=Retry after auth fix; rotate key if repeated failures continue.
  • 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
  • 500 internal_error: trigger=Transient upstream error or internal processing failure.; fix=Capture request id and trigger retry workflow.; retry=Retry 2-3 times with short delays; escalate if persistent.
xAI logo

Grok Video 1.5

Commercial use

Request text-to-video, first-frame image-to-video or reference images-to-video. Available modes and durations depend on the channel.

Model Type:
Pricing: Grok Video 1.5 from $0.012/s
480p $0.012/s· 720p $0.012/s

Input

FormJSON

First frame

Describe subject, camera, scene, and style.232 / 1200

Advanced options

Example params

Output

PreviewJSON
View API DocsGet API Key

Generation takes some time. Please wait.You can leave this page. [ Task Logs ] lets you check the generated content directly.

Request preview

{
  "model": "grok-video-1.5",
  "prompt": "(0-5s) Medium shot, she speaks warmly while gesturing to a product. (5-10s) Slow push-in to a close-up, glowing skin and expressive eyes. (10-15s) Cut to an over-shoulder framing of the vanity as she smiles. Glossy, warm, cinematic.",
  "duration": 10,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "video_generation_mode": "first_frame_image_to_video",
  "_error": "__i18n:errors.grokVideo15NeedsImage"
}

1

First-frame image

1–15s

Durations

Live

Billing

API

Production ready

Generated examples

Explore what Grok Video 1.5 can create

Create with this model

15s image-to-video result

Additional 15s motion example

Second 15s motion example

Transparent pricing

grok-video-1.5 pricing

Current ToAPIs pricing follows the same production quote rules as the pricing page. Final billing depends on resolution and duration.

Top up credits

480p

ToAPIs

$0.012

second

720p

ToAPIs

$0.012

second

Prices match the current /pricing quote for grok-video-1.5. Final billing follows the current account pricing, resolution, and duration.

Why ToAPIs

Why use ToAPIs for Grok Video 1.5?

Use one API key for image-to-video, pricing checks, async status polling, and broader model routing.

Explicit generation modes

Choose text-to-video, first-frame image-to-video or reference images-to-video. Channels may implement single-image inputs differently.

Transparent per-second cost

Jobs are priced at $0.01 per generated second, with live account billing confirmed before submission.

Unified video workflow

Submit a video task, poll status, and reuse the same dashboard for Sora, VEO, Kling, Seedance, and Grok.

Generate a Grok video in three steps

Test motion in the browser, then move the same request shape into production.

  1. 1

    Choose a mode and images

    Use no images for text-to-video, one first-frame image, or 1-7 reference images. JPEG, PNG and WebP are supported.

  2. 2

    Choose duration and format

    Describe the motion, then choose 1-15 seconds, resolution, and aspect ratio.

  3. 3

    Poll task status

    Use the returned task ID with the video status endpoint until the generated video URL is ready.

Built for modern video teams

Product motion tests

Animate a product still into a short commerce video for ads, listings, and launch pages.

Storyboard validation

Turn approved frames into short motion drafts before a longer production pass.

Creator workflows

Batch-test image concepts and keep only the motion candidates that fit your campaign.

FAQ

Grok Video 1.5 FAQ

Does Grok Video 1.5 support text-to-video?

Yes, when a channel enables it. Select text-to-video and send a prompt without images. New modes are not enabled on every channel.

Can I combine a first frame with reference images?

Yes, when the channel enables combined input. Choose First frame + reference images-to-video and provide one first frame plus 1-7 references at 480p or 720p. The first frame and references keep separate roles. Availability depends on the channel.

How many reference images can I use?

Reference images-to-video accepts 1-7 images at 480p or 720p, subject to channel limits. Set video_generation_mode to reference_images_to_video even for one reference image.

What durations are supported?

Grok Video 1.5 supports 1 to 15 seconds. Final billing is $0.01 per generated second.

Grok Video 1.5 API

Create your first Grok video task

Start with free credits, validate the motion, then connect the API to your creative workflow.

Start for freeView API Docs

New users get 10 credits to test Grok Video 1.5.

Choose a generation mode, add a prompt and any required images, then test the motion before integrating the API.

Start with free credits