Bring short-video generation into a production workflow
Create a dedicated Grok Video API key to submit text-to-video or image-to-video jobs, and track every asynchronous task by ID.
Text-to-video and image-to-video on one API
Text to video
Describe the scene, subject, and camera motion to create a short video.
Image to video
Upload one reference image and bring it to motion.
Submit once and track the task to completion
Create and use a dedicated Grok Video API key to submit a generation.
Save the returned task ID and link it to your own record.
Poll status every 5–10 seconds until the task completes.
Stream or download the result and store the final file promptly.
Three core endpoints
curl https://api.gettoken.dev/v1/videos/generations \
-H "Authorization: Bearer $GETTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A quiet city street after rain",
"size": "1280x720",
"seconds": "8"
}'Specifications and cost
| Model | Best for | Verification | Size | Duration | Quota usage | RMB estimate |
|---|---|---|---|---|---|---|
| grok-imagine-video | Text-to-video / image-to-video | Accepted upstream | 480p · 848x480 | 1–15s | $0.50/s | ¥0.067–¥0.2/s |
| grok-imagine-video | Text-to-video / image-to-video | Generation verified | 720p · 1280x720 | 1–15s | $0.70/s | ¥0.093–¥0.28/s |
| grok-imagine-video-1.5 | Image-to-video (image required) | Accepted upstream | 480p · 848x480 | 1–15s | $0.80/s | ¥0.107–¥0.32/s |
| grok-imagine-video-1.5 | Image-to-video (image required) | Generation verified | 720p · 1280x720 | 1–15s | $1.40/s | ¥0.187–¥0.56/s |
| grok-imagine-video-1.5 | Image-to-video (image required) | Accepted upstream | 1080p · 1920x1080 | 1–15s | $2.50/s | ¥0.333–¥1/s |
RMB estimates use the current pricing-page purchasing-power range (1 USD ≈ ¥0.1333–¥0.40). Text-only requests to grok-imagine-video-1.5 fall back to the base model and use base-model pricing; an input image activates native 1.5. Preview is hidden from the public model list and retained only as a compatibility entry. Reference images support JPEG / PNG / WebP up to 60 MiB each. Final charges follow the upfront quote and Console usage records.
FAQ
Start with one controlled video task
Create a video API key, review the model, size, duration, and quote, then complete the first generation in the workspace.
Continue with GetToken
Compare plans, follow the setup guide, or check product and support details.