POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/grok-imagine-video-1.5-text-to-video"; const data = { "prompt": "A vintage red sports car speeding along a coastal cliffside highway at golden-hour sunset, cinematic tracking shot alongside the car, the engine roaring as waves crash against the rocks below and wind rushes past.", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Describe scene, subject, camera move and sound design. Front-load the key action.


durationint ( default: 6 ) Affects Pricing

Clip length in seconds, 1 to 15. Use 4-6 for cinematic shots.

min : 1,

max : 15


resolutionenum:str ( default: 720p ) Affects Pricing

Output quality: 480p, 720p or 1080p. Use 720p for balanced showcases.

Allowed values:


aspect_ratioenum:str ( default: 16:9 )

Frame shape, seven presets. 16:9 for cinematic, 9:16 for social verticals.

Allowed values:

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Grok Imagine Video 1.5 Text to Video

Grok Imagine Video 1.5 Text to Video is xAI's text-to-video model that turns a written prompt into a cinematic clip with natively generated, synchronized audio — no starting image required.

What is Grok Imagine Video 1.5 Text to Video?

Grok Imagine Video 1.5 Text to Video is the generally available text-to-video mode of xAI's Grok Imagine Video 1.5. You describe a scene, subject, camera move, and sound design in plain language, and the model returns an MP4 with picture and audio produced together in a single pass. It is built on xAI's Aurora engine, which renders each clip frame by frame so motion, lighting, and camera trajectory stay coherent across the shot. Outputs run from 1 to 15 seconds at 480p, 720p, or native 1080p, across seven aspect ratios.

Key Features

  • Native synchronized audio: dialogue, ambient sound, sound effects, and background music generated in the same pass — no separate audio tool or alignment step.
  • Prompt-only generation: create a new scene from text alone, no reference image needed.
  • Up to native 1080p at 24fps, with 480p and 720p tiers for faster drafts.
  • Flexible duration from 1 to 15 seconds and seven aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3).
  • Fast, coherent motion from the autoregressive Aurora engine.

Best Use Cases

Grok Imagine Video 1.5 Text to Video is strongest for social-native short clips for TikTok, Reels, Stories, and X, where native audio removes post-production overhead. It also suits cinematic teasers and ad creative, product and concept b-roll, and rapid pre-visualization for storyboards and camera tests. In testing, 720p prompts returned clean, artifact-free clips with well-synchronized ambient audio and smooth cinematic tracking, generated in roughly 45 seconds.

Prompt Tips and Output Quality

Front-load the key action: the model renders actions described early in the prompt early in the clip, so lead with the main motion, then add camera direction and sound cues. Because audio is generated natively, name the sounds you want ("engine roaring", "waves crashing"). Use 480p for quick drafts, 720p as a balanced showcase, and 1080p for hero shots. Keep clips to 4-6 seconds for the tightest cinematic results.

FAQs

Does Grok Imagine Video 1.5 Text to Video generate audio? Yes. Every clip includes native, synchronized audio — dialogue, ambient sound, effects, and music — created in the same generation pass as the video.

Do I need a starting image? No. This is text-to-video: it generates a full scene from a prompt alone.

What resolutions and durations are supported? 480p, 720p, and native 1080p, at 1 to 15 seconds per clip.

What aspect ratios can I use? Seven presets: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, and 2:3.

How do I get longer sequences? Generate multiple clips and chain them, continuing from the final frame to maintain motion and lighting continuity.