Grok Imagine Video 1.5 API
上传 1 张图片,描述主体动作、镜头运动和声音,即可生成 1–15 秒的短视频。通过 EvoLink 可在生成前查看预计费用,并用统一 API 将结果接入业务。
接入 API 前,先在 Playground 里试跑一次
上传 1 张图片,填写动作和运镜提示词,再选择时长与分辨率。提交前可以查看预计消耗,生成完成后可直接预览结果。
生成测试视频
上传 1 张图片,填写 Prompt 并设置生成参数。必填。请上传且仅上传 1 张图片;当前模型只支持图生视频。
1generated-image.png
—
✓ 已添加 1 张图片
Grok Imagine Video 1.5 图生视频价格
费用由视频时长、分辨率和输入图片三部分决定。输出视频按秒计费,每次生成还会收取 1 张输入图片的固定费用。
第一次测试要花多少?
图生视频 · 6 秒 · 480p · 1 张图片生成 1 条 6 秒 480p 视频,包含 1 张输入图片
$10 额度大约可以测试 25 次
建议先用 480p 调整动作、运镜和构图,效果确认后再切换到 720p,减少无效消耗。
测试预算参考
根据预计测试次数选择充值金额。适合首次验证模型效果。
适合反复调整动作和构图。
适合正式接入前进行较完整的测试。
常见生成费用
以上为单次图生视频的预计总费用,均包含 1 张输入图片。实际费用会随时长和分辨率变化。
详细价格
-20%| 生成方式 | 480p | 720p | 计费单位 |
|---|---|---|---|
| 图生视频输出视频按秒计费 | $0.064/s-20% 4.352 cr/s$0.080 官方价格 | $0.112/s-20% 7.616 cr/s$0.140 官方价格 | 按输出视频秒数计费 |
输出视频按秒计费,720p 的费率是 480p 的 1.75 倍;每次图生视频还会收取 1 张输入图片的固定费用。
Grok Imagine Video 1.5 适合做什么?
Grok Imagine Video 1.5 是 xAI 正式发布的图生视频模型。每次上传 1 张图片,并用 Prompt 描述人物动作、镜头运动和声音,即可生成 1–15 秒的 480p 或 720p 短视频。通过 EvoLink 还能在生成前查看预计费用,并与其他模型共用同一个 API Key。
它最擅长什么
用一张图控制动作与运镜
商品图、人像、插画或分镜图负责确定主体与构图,Prompt 重点描述人物怎么动、镜头怎么走以及画面节奏。
画面与声音一次生成
生成视频的同时可以加入环境音、动作音效和人物对白。正式发布前仍建议检查声音是否自然、是否与画面同步。
适合接入业务的异步任务流程
提交任务后,可通过轮询或回调获取生成状态;视频完成后请及时下载,或保存到自己的存储服务。
适合用来做什么
接入前先确认这些规格与限制
| 规格 | Grok Imagine Video 1.5 | 对接入的影响 | 不适合这些需求 |
|---|---|---|---|
| 生成方式 | 仅支持单图图生视频 | 输入图片会决定视频的主体和起始构图。 | 只输入 Prompt 就直接生成视频。 |
| 输入要求 | 1 张图片 + 非空提示词 | 提交前必须同时检查图片和 Prompt。 | 需要多张参考图或首尾帧控制。 |
| 时长与输出 | 480p 或 720p,时长 1–15 秒 | 视频越长、分辨率越高,费用越高。 | 需要更长的视频或 1080p 输出。 |
| 输出构图 | 跟随输入图片 | 请按最终发布画幅准备输入图片。 | 需要使用首尾帧控制转场。 |
| 任务方式 | 异步生成,支持轮询或回调 | 任务完成后要做好去重,避免重复处理结果。 | 必须立即同步返回生成结果。 |
| 计费 | 按输出秒数计费,另收输入图片费用 | 应在提交前估价,并限制失败重试带来的额外费用。 | 需要与视频时长无关的固定价格。 |
调用前需要知道的三件事
正式模型与调用 ID 不同
xAI 的正式模型 ID 是 grok-imagine-video-1.5;通过 EvoLink 调用时,请使用示例中显示的 grok-imagine-video-1.5-preview。
每次只能上传 1 张图片
图片需为 JPEG、PNG 或 WebP,大小不超过 10 MB,并且 Prompt 不能为空。当前不支持文生视频、多张参考图或首尾帧模式。
生成结果需要及时保存
任务提交后可通过轮询或回调获取状态。结果链接只保留 24 小时,请及时下载,或保存到自己的存储服务。
为什么通过 EvoLink 接入
生成前查看费用
根据视频时长、分辨率和输入图片计算预计消耗,减少无效测试。
一套 API 接入多个模型
使用同一套鉴权和调用方式接入 Grok Imagine 及其他视频模型。
一个账户管理余额
在同一个 EvoLink 账户里查看余额、支出和各模型用量。
统一跟踪任务状态
用一致的异步流程查看等待中、生成中、已完成和失败的任务。
按场景选择合适模型
需要单图生成短视频时使用 Grok 1.5,其他输入方式可切换到更匹配的模型。
Grok Imagine 模型系列
查看所有模型
EvoLink 上的其他视频模型




常见问题
什么是 Grok Imagine Video 1.5?
Grok Imagine Video 1.5 是 xAI 正式发布的图生视频模型。上传 1 张图片,并用 Prompt 描述动作、运镜和声音,即可生成带同步音频的短视频。
在 EvoLink 上应使用哪个模型 ID?
通过 EvoLink 调用时,请使用 grok-imagine-video-1.5-preview。xAI 的正式模型 ID 是 grok-imagine-video-1.5,不同接入渠道使用的 ID 可能不同。
为什么 EvoLink 模型 ID 中仍包含 preview?
preview 仍是 xAI 保留的兼容别名,也是 EvoLink 当前公开使用的调用 ID。这不代表 xAI 仍将 1.5 归类为预览版。
Grok Imagine Video 1.5 支持文生视频吗?
不支持。当前模型必须上传 1 张图片才能生成视频。如果只想输入 Prompt 直接生成,请选择其他支持文生视频的模型。
可以使用多张参考图或首尾帧吗?
不可以。每次生成必须上传且只能上传 1 张输入图片,当前不支持多张参考图控制,也不支持首尾帧模式。
对图片和提示词输入有什么要求?
图片需为 JPEG、PNG 或 WebP,大小不超过 10 MB;Prompt 不能为空,最多 2,000 tokens(中文等非拉丁文字每个字符占用的 token 更多)。提交任务前请同时检查图片和 Prompt。
Grok Imagine Video 1.5 的费用是多少?
费用由输出时长、分辨率和输入图片共同决定。请以页面价格区块和 Playground 的实时估价为准,不要依赖其他页面复制的静态价格。
支持哪些分辨率和时长?
EvoLink 当前支持 480p 和 720p,时长可选 1–15 秒。xAI 文档也列出了 1080p,但 EvoLink 当前暂未开放这一规格。
输出画幅如何确定?
当前接口不提供画幅比例参数。请按希望视频跟随的最终构图准备输入图片。
Grok Imagine Video 1.5 会生成音频吗?
可以。模型能在生成视频的同时加入环境音、动作音效和人物对白。不同场景的声音效果可能有差异,正式使用前请检查音画同步和声音自然度。
如何接收生成完成的视频?
生成采用异步任务方式。提交后可以轮询任务状态,也可以提供 HTTPS 回调地址;任务完成后请及时下载视频,或保存到自己的存储服务。
结果 URL 可以使用多长时间?
结果链接的有效期为 24 小时。请及时下载,或转存到自己的对象存储;不要在正式业务中长期引用临时链接。
失败或被审核拦截的请求一定免费吗?
不一定。生成失败或触发内容审核时,请以任务返回的用量信息和账户账单为准;自动重试前应先确认是否已经产生费用。
API Reference
Select endpoint
Authentication
All APIs require Bearer Token authentication.
Authorization:
Bearer YOUR_API_KEY/v1/videos/generationsCreate Image-to-Video
xAI Grok Imagine Video 1.5 Preview animates a single reference image into a short video. This model is image-to-video only — a request without an image is rejected.
Asynchronous processing — use the returned task ID to . Result links are valid for 24 hours.
Request Parameters
modelstringRequiredDefault: grok-imagine-video-1.5-previewFixed value: grok-imagine-video-1.5-preview
grok-imagine-video-1.5-previewpromptstringRequiredText prompt to guide the motion and style of the generated video.
Notes
- Required (≤ 2000 tokens; CJK text uses more tokens per character)
Use the input image as the exact opening frame and preserve the original character, outfit, cybernetic arm, hairstyle, jacket graphic, balcony structure, city layout, and overall composition.
A single continuous 6-second cinematic cyberpunk shot at night. The camera begins directly behind the lone cybernetic woman and slowly dollies forward while making a subtle clockwise arc toward her right shoulder, creating strong layered parallax between the wet metal railing, the character, nearby flying traffic, and the distant skyscrapers.
The woman remains facing the city and does not turn around. She subtly shifts her weight and takes a slow breath; her shoulders move naturally, her short black hair and leather jacket flutter gently in the high-altitude wind. Small orange lights beneath the cybernetic implants on her neck and robotic arm pulse softly. Rainwater beads, streams, and reflects neon light across her jacket, metal arm, railing, and platform.
Heavy rain falls through the entire city with realistic depth. Volumetric mist drifts between the skyscrapers. Holographic billboards flicker, scan, and cast shifting cyan, magenta, and amber light across the buildings. Neon reflections ripple naturally across wet metal and glass. Numerous flying cars move through different depth layers at different speeds, producing realistic atmospheric perspective and complex city traffic.
At the middle of the shot, a large armored hovercraft passes rapidly through the midground from right to left, briefly illuminating the woman’s silhouette with sweeping red and blue light. Its engines push rain and fog outward, creating a visible wave of mist and subtle vibration in her jacket and hair.
During the final second, a distant lightning flash illuminates the clouds and reveals the enormous vertical scale of the megacity. The camera gently settles just behind her right shoulder without revealing her face, ending on a powerful view of the living neon city.
Photorealistic, ultra-detailed cyberpunk environment, cinematic sci-fi film quality, realistic rain physics, physically accurate lighting, deep atmospheric perspective, volumetric fog, complex environmental motion, strong parallax, subtle camera micro-movement, controlled motion blur, anamorphic lens, high contrast, dark blue and cyan night atmosphere, magenta neon accents, fluid motion, stable character anatomy, one uninterrupted shot, no cuts.image_urlsarrayRequiredReference image URL. Image-to-video only — exactly one image.
Notes
- Required. Exactly 1 image
- Formats: .jpg, .jpeg, .png, .webp
- Max 10MB per image
- URL must be directly accessible
["https://cdn.evolink.ai/Model-Example/GrokImagine1.5/generated-image.png"]durationintegerOptionalDefault: 6Output duration in seconds.
| Value | Description |
|---|---|
| 1-15 | Any integer between 1 and 15 (step 1) |
Notes
- Duration directly affects billing
6qualitystringOptionalDefault: 480pOutput resolution.
| Value | Description |
|---|---|
| 480p | Standard (default) |
| 720p | HD, billed at ×1.75 |
480pcallback_urlstringOptionalHTTPS callback URL for task completion notification. Triggered when the task completes, fails, or is cancelled (HTTPS only).
https://your-domain.com/webhooks/video-done