Grok Imagine Video 1.5 API
AI 视频Grok Imagine Video 1.5 是 xAI 在 OmniaKey 上首个上线的视频路由,通过同一套异步媒体 API 支持文生视频与首帧图生视频,按输出秒数计费。
- 每输出一秒$0.30
- 操作文生视频
- 图生视频
- 查看工具价格与计费规则
运行模型后,结果会显示在这里。
01
适用场景
Grok Imagine Video 1.5 是 xAI 在 OmniaKey 上首个上线的视频路由,通过同一套异步媒体 API 支持文生视频与首帧图生视频,按输出秒数计费。
需要从提示词或单张首帧生成短片、并希望成本随片长变化时选 Grok Imagine Video 1.5;如果需要自带音轨的更长片段或更高画面保真度,可以改用 Seedance、HappyHorse 或 Wan 3.0。
02
能力范围
文生视频
grok-imagine-video-1.5
根据文字提示词生成一段短视频。
图生视频
grok-imagine-video-1.5
把静态图片动起来,生成一段短视频。
03
深入了解
Grok Imagine Video 1.5 是 xAI 在 OmniaKey 上的视频模型,ID 为 grok-imagine-video-1.5,按输出秒数一档计费。它最高出 720p,时长取 4 到 15 秒,支持九种画幅,默认 16:9。
这个模型是围绕声音设计的:成片自带一条立体声音轨,包含音效、环境声与对白,而提示词里的声音描述也会影响画面。我们那条咖啡片段的声音句提到勺子,画面里果然在 4.5 秒出现了勺子和一只手。
xAI 在 2026 年 6 月 16 日把 1.5 转为正式版。我们记录在案的是一次 2026 年 10 月 24 日的 6 秒 720p 文生视频任务,下方引用的两条报错路径与链接过期时间也来自这次。
以声音带节奏的短广告
在画面描述后另起一行写 Sound,模型会把声音安排进镜头:勺子碰碟、门后的脚步。竖屏短片的记忆点常来自这一句,写好它比多加十个形容词有用。
非常规画幅
九种画幅里有 21:9、5:2、3:2 与 2:3,横幅贴片或印刷感竖构图都不必重构画面。比例写在参数里,不写就是 16:9。
先用最短时长试拍
费用随时长变化,失败任务会退回,所以先用最短的 4 秒试一条运镜,再决定要不要排满 15 秒,是控制预算的常规做法。
04
实测记录
我们那条 6 秒 720p 的 Grok Imagine Video 1.5 片段在发出请求 46 秒后就绪,返回时带一条音轨。
阅读实测记录6 秒的 Grok Imagine Video 1.5 请求返回的文件长 6.04 秒,计费按我们所要求的 6 秒计算。
阅读实测记录在那条咖啡片段里,Grok Imagine Video 1.5 让勺子和一只手出现在画面中,而这两样只写在我们给的声音描述里。
阅读实测记录2026 年 10 月 24 日,我们把任务的幂等键配上改过的提示词重发,Grok Imagine Video 1.5 返回 HTTP 409,没有创建新任务。
阅读实测记录我们的 Grok Imagine Video 1.5 下载链接在任务完成后整一小时过期,只好再轮询一次任务拿新地址。
阅读实测记录
05
需要预留的限制
- 这里最高只有 720p。xAI 自家接口还列了 480p 与 1080p,但本目录按最高 720p 提供,请求 1080p 没有对应档位。
- 低于四秒的时长会被拒绝,尽管 xAI 自家接口最低可到一秒,所以两秒的片头在这里提不出来。
- 签名下载链接只保留约一小时,任务记录却保留一天;错过时间窗就重新轮询同一个任务,而不是重渲一遍。
- 幂等键配上改动过的请求体会返回冲突而不是新任务,重试循环里顺手改提示词就很容易踩到。
06
对比相近模型
| 模型 | 更适合 | 操作 | 标价 |
|---|---|---|---|
| Grok Imagine Video 1.5当前页 grok-imagine-video-1.5 | 单一每秒费率,720p,4 到 15 秒,九种画幅,默认带声音。 | 文生视频 · 图生视频 | $0.30 每秒 |
| Kling 3.0 kling-3.0 | 固定 5、10、15 秒,由档位参数决定分辨率。 | 文生视频 · 图生视频 | $0.80–$3.00 每次调用 |
| MiniMax H3 minimax-h3 | 768P 或 2K,支持参考素材,但请求里关不掉音轨。 | 文生视频 · 图生视频 · 参考生视频 | $0.0269–$0.0431 每秒 |
08
接入方式
媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: grok-imagine-video-1.5-001" \
-d '{
"model": "grok-imagine-video-1.5",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The same model id and the same poll loop serve the other operations:
# image_to_video media[] type "first_frame"
# Reference media travel alongside the prompt:
# {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
# A public HTTPS URL or a base64 data URI both work.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"09
价格
视频任务按实际输出的秒数计费,不按 Token 计费;失败或取消的任务会自动退款。
$0.30每秒
xAI 的更多模型
相关文章
常见问题
如何在 OmniaKey 上调用 Grok Imagine Video 1.5?
向 /v1/media/tasks 发送 POST,带上模型 ID、type 设为 "video"、operation 设为 "text_to_video";若用首帧图生视频,改为 "image_to_video",并把首帧放入 input.media[](type 设为 "first_frame")。重试时复用同一个 Idempotency-Key,超时就不会再生成第二笔付费任务。
Grok Imagine Video 1.5 如何收费?
Grok Imagine Video 1.5 按生成视频的时长计费:$0.30 每秒。创建时会按请求时长从预付余额中预扣,失败或取消的任务会自动退款。
为什么接口返回任务 ID 而不是视频?
视频渲染大约需要一分钟到几分钟,OmniaKey 因此把所有视频路由统一为同一套异步流程。轮询 GET /v1/media/tasks/{id},直到状态变为 succeeded,再读取签名后的资源地址。
时长可以设多长?
4 到 15 秒,用 duration 指定且必填。xAI 自家接口最短接受一秒,而本目录对该模型的下限是四秒,更短的请求在任务建立前就会以价格错误返回。
这个模型会生成声音吗?
会,默认就有。成片带音效、环境声与对白,我们那条文件是立体声 AAC。xAI 接口提供 generate_audio false 的开关;文件已下载的情况下,保留视频流、去掉音轨也只差一步剪辑。
重试为什么返回 409?
因为幂等键被用在了不同的请求体上。这个键标识一次请求,改了提示词却沿用旧键,重试就变成冲突而不是第二个任务。新提示词换新键,旧键只用于原样重放。
下载链接能保留多久?
约一小时,我们那条正好在任务完成后整点过期。任务记录会留一天,所以重新轮询同一个任务 ID 就能拿到新的签名地址,不必为同一条提示词再付一次钱。
能把静图做成视频吗?
目录里列了文生视频与图生视频,xAI 自家接口接受一张图作为首帧、提示词可选,并保留图片原有画幅。我们记录在案的是文生任务,接入流程前建议先跑一条短图生任务确认请求结构。
