1. 先给结论
开发者讨论里最集中的失败，不是提示词不够电影感，而是：图生视频没传图、把同步聊天超时套到视频上、以及免费档额度先被媒体能力打满。企业用法应当把视频当成后台作业：提交、轮询、转存、对账。
接入细节保留在Grok 视频生成 API。本篇补的是选型、计费和稳定性边界。旧路径 /guides/grok-image-to-video/ 保持 noindex，请使用规范视频指南。
2. 文生视频和图生视频不要混
| 型号 | 输入 | 典型错误 |
|---|---|---|
| grok-imagine-video | 文本提示词 | 误当成必须带图 |
| grok-imagine-video-1.5 | 首帧/参考图 + 提示词 | 不带图把错误丢给上游 |
1.5 的产品定位是“让静帧动起来”。缺图时不要指望接口替你脑补一张封面。参考图用普通位图，不要用 SVG。
3. 异步任务怎么写才不会假失败
创建接口成功时，你拿到的是 request_id 或同等任务 ID，不是 MP4。接下来才是查状态、下载 /content。查询必须用同一把 Key，否则会出现“任务不存在”。
1. POST 创建任务，保存 request_id
2. GET 轮询 status，直到完成或失败
3. 下载视频并转存到自有存储
4. 用控制台流水核对秒数与金额轮询间隔用有限次数，不要死循环打满网关。HTTP 工作线程里同步死等，会把企业网关拖成雪崩。更稳的是把任务放到自己的队列。
4. 0.05 元/秒怎么理解“便宜”
官方视频按秒、按分辨率计价，公开资料常见 480p 与 720p 不同单价。本站目录是 0.05 元/秒。6 秒草稿和 15 秒成片的成本差一倍以上，所以“便宜”取决于你把时长和分辨率写死没有。
- 先定最长秒数，再开放提示词。
- 失败重试会再次按秒计费，要限制自动重试。
- 不要把文字 0.1x 倍率和视频按秒价加总后说“平均倍率”。
5. 企业队列式用法
- 提交服务和轮询服务分开，避免网关线程被单任务占满。
- 每个任务记录模型、秒数、分辨率、参考图哈希、操作者。
- 生产 Key 单独限额；演示环境禁止无上限并发生视频。
- 完成文件转存后才给前端播放地址，不依赖上游临时 URL。
- 审核拒绝、上游 429、超时要区分错误码，便于值班。
消费级免费账号在媒体能力上先被限流，是公开讨论里的常见现象。生产线不要建立在免费额度上。
6. 常见失败
- 1.5 不带图。
- 创建成功却按聊天超时去报错。
- 换一把 Key 去查询任务。
- 把图片模型 ID 填进视频接口。
- 用延长/拼接思路硬接两段视频，却没有验证运动连续性——那是另一类能力，本站未验证就不承诺。
静帧从哪来？通常先走Grok 生图，再把成品当首帧。
8. 推荐的任务状态机
用四个状态就够：queued、running、succeeded、failed。不要让前端用转圈 30 秒没回来当失败。
- queued：已有 request_id，未进入上游处理。
- running：开始轮询，记录第一次非排队状态的时间。
- succeeded：文件转存完成才对用户可见。
- failed：保存错误体，禁止无上限重试。
并发上限按 Key 设。视频比文字更容易打满上游，企业如果开 50 路并发生 10 秒视频，账单和稳定性会一起坏。
9. 按秒算的两个例子
目录价 0.05 元/秒只是单价。
- 6 秒预览乘 20 条分镜等于 6 元目录价，尚未计入失败重试。
- 15 秒成片乘 20 条等于 15 元。若其中 8 条因缺图失败又各重试一次，秒数可能接近翻倍。
因此要在创建前校验参考图，而不是创建后再说好便宜。分辨率字段一旦被渠道接受，不要在失败后自动升档重打。
10. 创建前检查清单
提交前用代码挡住注定失败的请求，比事后解释更便宜。
- 1.5 档：参考图 URL 可访问，或本地文件已转成接口接受的格式。
- 时长字段不超过渠道当前上限；超限应在本地拒绝。
- prompt 描述运动，而不是再描述一张新海报。图生视频要的是镜头，不是重画。
- 同一分镜的重试次数写入任务表，超过阈值转人工。
- 下载完成后校验 Content-Type 是否为视频，避免把 JSON 错误页存成 mp4。
这些检查来自反复出现的失败模式：缺图、超时长、用错模型、把查询 Key 换掉。页面不引用任何第三方站点名称。
11. 视频比图片更需要人工闸门
按秒计费意味着错误更贵。一张废图可能只要 0.01 元；一段 10 秒失败重试三次，目录价已经到 1.5 元，还没算人工时间。
因此图生视频应放在生图验收之后：静帧构图、主体、文字都过了，再提交视频。把“先出视频再修图”倒过来，是把贵的步骤放在未验证的输入上。
对外承诺只写：异步任务、按秒目录价、控制台为准。不写固定出片秒数，不写分辨率竞赛，不写成功率。这些数字没有本站样本就不能出现在标题里。
7. 常见问题
Grok 图生视频一定要图吗？
grok-imagine-video-1.5 要。纯文本请用 grok-imagine-video。
多久能出片？
本文不给未验证的秒数承诺。以任务状态为准，并在自己的环境里记录耗时分布。
1080p 能用吗？
以当前渠道实际接受的分辨率字段和控制台为准，不把第三方文档的档位抄成本站能力。
官方视频按秒、按分辨率计费及 Imagine Video 能力来自 xAI 公开说明，核对日期 2026-09-08。本站目录价 0.05 元/秒，以控制台为准。