zmgid Grok Imagine Video Official API
Use the bundled dependency-free scripts/grok_video.py client. It reads the grok URL, API key, and selected model from the current user's dsvideo/providers.json, and falls back to grok-imagine-video-1.5 on the official https://api.x.ai endpoint when no saved URL/model exists. The legacy XAI_API_BASE, XAI_API_KEY, and XAI_VIDEO_MODEL variables remain supported as overrides.
Before a paid request, read references/grok-video-api.md. Run quote before presenting this route. xAI does not document a balance-query endpoint, so state that account balance must be checked in xAI Console; do not invent a balance.
Required rules
- Preserve the current task’s agreed script, product, language and audio across follow-ups. Consolidate missing choices and cost confirmation into one question. A user instruction to generate the displayed plan or a specific variant is authorization for that variant; do not ask again for unchanged choices. Newly invented scripts or an unconfirmed paid cost require confirmation. Preparation and free dry runs may run before confirmation.
- Read credentials from the saved
grokprovider or the legacyXAI_API_KEYoverride. Never print or place a literal key in a command. - Obtain an explicit
480p,720p, or1080pchoice for the current task. Never infer or silently change it. Reuse the user’s existing choice unless they change it. - Show the USD estimate from
quote, including the selected duration and whether one source image is charged, before asking the user to choose Grok. - Run
--dry-runfirst and compare model, resolution, duration, aspect ratio, mode, and audio with the confirmed request. - Run exactly one
generatecommand for a completed file. It submits once, prints the request ID, polls that request, checks returned duration, and downloads the MP4. - After timeout or interruption, resume with
statusorwaitand the same request ID. Never resubmit automatically. - A dry run is free but does not verify credentials or produce a video.
Quote
python <skill-directory>/scripts/grok_video.py quote --duration <1-15> --image-count <0-or-1>
The current official output rates are USD $0.08/sec for 480p, $0.14/sec for 720p, and $0.25/sec for 1080p. Image input adds $0.01 per image. Treat the quote as an estimate and link the official pricing page.
Generate
python <skill-directory>/scripts/grok_video.py generate \
--prompt "<confirmed prompt>" \
--resolution <480p-or-720p-or-1080p> \
--duration <1-15> \
--ratio <ratio> \
[--image <local-path-or-public-url>] \
[--no-audio] \
--output <output.mp4>
Run the same command with --dry-run before removing that flag for the paid call. Local JPG/JPEG/PNG/WebP images are converted to data URIs; public HTTP(S) URLs and existing data URIs pass through.
Recover
python <skill-directory>/scripts/grok_video.py status <request-id>
python <skill-directory>/scripts/grok_video.py wait <request-id> \
--expect-resolution <resolution> --expect-duration <seconds> --output <output.mp4>
The result URL is temporary, so download promptly. The client accepts both absolute xAI URLs and gateway-relative /v1/videos/.../content URLs; it sends the API credential on relative same-gateway downloads only. Deliver the local MP4 path, request ID, mode, selected resolution, verified duration, aspect ratio, and that Grok was the paid route.
Execution context
Read 运行与恢复 before running commands. Keep requested speech and its language when switching routes or shortening a video. Official price estimates are not a custom gateway invoice.