grok-imagine-video-1.5

by xAIVideo

Non-official Grok 1.5 image-to-video generation requiring exactly one source image, with 1–15 second duration and up to 1080P output.

InputPrompttext
Models1available
FlowAsyncresult URL
Price2 quota480P or 720P
Example clip16:9 landscape preview
Example clip

15-second cinematic historical period-drama scene, realistic, intimate, elegant, restrained, filled with quiet longing. A woman remains SEATED at a writing desk beside a rainy leaded window, writing a personal letter to someone she once loved. Aristocratic interior, aged wood, period dress, feather pen, old paper. Warm flickering candlelight contrasts with cool blue-gray rainy daylight. Emotional rhythm: WRITE → THINK → WINDOW GLANCE → WRITE → PAUSE → SECOND WINDOW GLANCE → FINISH → LEAN BACK → LOOK OUT WINDOW. 0–3s: Close-up of feather pen slowly writing beside a candle. The pen briefly hesitates above the paper. Camera gently reveals her thoughtful face. 3–6s: Writing slows. She pauses, subtly tightens her lips, then makes a brief FIRST glance toward the rainy window. She returns to the page and continues writing. 6–9s: The pen pauses again. Her free hand lightly touches the letter. She makes a SECOND, longer window glance. Her eyes soften and lose focus slightly, as if remembering someone far away. Candlelight warms one side of her face while cool window light shapes the other. 9–12s: She returns to the page and slowly writes a final line. Her expression softens from emotional weight into tenderness and longing. 12–15s: She stops writing, lowers the pen, and gently LEANS BACK INTO THE CHAIR. She remains seated. Her shoulders relax as she looks toward the rainy window with a soft, distant gaze and the faintest private smile. End there. Performance: Natural micro-expressions: small writing hesitations, hovering pen, trembling lashes, subtle breathing, slight mouth tension, softened eyes, brief loss of focus. No crying or melodrama. Camera: One continuous smooth cinematic shot. Start close on pen, paper and candle, drift naturally to hands and face, capture both window glances, then end on her seated profile looking toward the window. No abrupt cuts or flashy movement. Audio: No dialogue or voiceover. Soft pen on paper, rain, candle ambience, fabric movement, light wind against glass, subtle chair creak. Minimal melancholic period piano or strings, warming slightly near the end. STRICT: She stays seated for the entire scene. Never stands or walks to the window. Two window glances while writing. Writing is repeatedly interrupted by thought. End leaning back in the chair looking toward the window. No subtitles, captions or on-screen text.

Image to video · Non-official · 15s · 16:9 landscape
Examples

Prompt to video, in context

Capabilities

What you can build with grok-imagine-video-1.5

Prompt driven generation

Submit a concise prompt and get production-ready video output through one TTAPI job.

Core controls only

Keep integration simple with prompt, model, output settings, and callback handling.

Async result flow

Use polling or webhook callbacks so long-running generations do not block your UI.

Ready for product UI

Return grok-imagine-video-1.5 results that can be displayed, stored, or passed into downstream workflows.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Non-official per-second pricingOfficial pricing
ResolutionPriceUnit
480P / 720P2 quota/ second
1080P4 quota/ second
API request

grok-imagine-video-1.5 operations and request fields

Use the endpoint below with your TTAPI key and the request fields shown.

GeneratePOST
/grok/generations

Submit a non-official Grok video task with video_length, resolution_name, reference images, and an optional callback.

Official reference
POSThttps://api.ttapi.io/grok/generations

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

promptstringrequired

Generation prompt. Base and 1.5 accept up to 4,096 characters; 1.5 Fast supports longer prompts.

modelenumoptional

Defaults to grok-imagine-video-1.5-fast. Also supports grok-imagine-video and grok-imagine-video-1.5.

aspect_ratioenumoptional

Defaults to 16:9. Supported: 2:3, 3:2, 1:1, 9:16, and 16:9.

video_lengthstringoptional

Defaults to 10. Fast supports 6–30 seconds; base and 1.5 support 1–15 seconds. Base supports up to 15 seconds with one image and up to 10 with multiple images.

resolution_nameenumoptional

Defaults to 720p. 480p and 720p work across all models; 1080p is supported only by grok-imagine-video-1.5.

refer_imagesstring[]conditional

Reference-image URLs. Fast accepts up to 7; base accepts multiple; 1.5 requires exactly one image.

voice_idenumoptional

Voice role ID for the generated video audio. Options include carina, zagan, helix, orion, luna, iris, altair, and zenith.

hook_urlstringoptional

Callback URL notified when the job completes or fails; otherwise retrieve the result through Fetch.

Open the official TTAPI documentation
Integrate

From key to first result

Copy the resolved endpoint, authentication headers, and request body for this model.

curl --request POST \
  --url https://api.ttapi.io/grok/generations \
  --header 'TT-API-KEY: $TTAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"model":"grok-imagine-video-1.5","prompt":"a young man closes his eyes on a crowded nightclub dance floor","aspect_ratio":"2:3","video_length":"6","resolution_name":"1080p","refer_images":["https://example.com/first-frame.jpg"],"voice_id":"luna"}'