TTAPI logoTTAPIDashboard

grok-imagine-video-1.5

by xAIVideo

Grok Imagine Video 1.5 API by xAI on TTAPI generates non-official 1–15 second clips from text, references, first/last frames, or timed keyframes up to 1080P.

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
First framePOST
/grok/generations

Anchor the opening image on 1.5 Fast or 1.5 with first_frame.

Official reference
Last framePOST
/grok/generations

Anchor the ending image on 1.5 Fast or 1.5 with last_frame.

Official reference
First and last framePOST
/grok/generations

Specify the opening and ending images on 1.5 Fast or 1.5.

Official reference
KeyframesPOST
/grok/generations

Pin up to 4 images at interior timestamps on 1.5 Fast or 1.5.

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, 1.5, and Lite 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, grok-imagine-video-1.5, and grok-imagine-video-1.5-lite.

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, 1.5, and Lite 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 by 1.5 and Lite. Lite 1080P is upscaled from 720P.

refer_imagesstring[]conditional

Reference-image URLs. Fast accepts up to 7; base accepts multiple. The 1.5 reference workflow uses one image; other 1.5 workflows use text or explicit frame controls.

first_framestringoptional

First-frame image URL. Supported by 1.5 Fast, 1.5, and Lite in the first-frame workflow.

last_framestringoptional

Last-frame image URL. Supported by 1.5 Fast and 1.5. Use the same image for first_frame and last_frame to create a loop effect.

reference_audiosobject[]optional

Voice-character objects for narration or dubbing, each containing voice_id. Accepts up to 3 entries.

hook_urlstringoptional

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

keyframesobject[]conditional

Required for keyframe-to-video on 1.5 Fast or 1.5. Up to 4 entries with image: { url } and timestamp_s. Timestamps must be inside the clip and at least 1/3 second apart; can be combined with first_frame and last_frame.

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"],"reference_audios":[{"voice_id":"luna"}]}'
Related

You might also use

grok-imagine-video-1.5-fast logoVideo

grok-imagine-video-1.5-fast

xAI

From 9 quota / 10 secThe pricing table lists 9 quota for 10 seconds, 20 quota above 10 through 20 seconds, and 30 quota above 20 through 30 seconds. The API also supports 6 seconds, but its price is not listed.
View model
grok-imagine-video logoVideo

grok-imagine-video

xAI

From 2 quota / secNon-official video generation is billed at 2 quota per second.
View model
grok-imagine-video-1.5 logoVideo

grok-imagine-video-1.5

xAI

from 4.8 quota / secOfficial transfer is 40% off official pricing; 480P starts at 4.8 quota per second plus 0.6 quota per input image.
View model