从场景描述开始创作
没有现成图片时，可以直接用文字描述主体、环境、动作和镜头意图，生成用于创意验证的短片。提示词宜围绕一个清晰的视觉事件展开，例如主体缓慢移动、镜头逐步靠近，再补充光线与氛围，便于比较不同描述的效果。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作方式
- 文生视频、图生视频
- 平台时长范围
- 1–15 秒，整数秒；默认 6 秒
- 输入形式
- 文本提示词 prompt；图片链接 image_url
- 平台画幅选项
- 1:1、16:9、9:16、4:3、3:4、3:2、2:3
- 调用入口
- POST /grok/videos，显式指定 grok-imagine-video:official
- 任务与交付
- 支持异步查询、完成回调；返回任务状态与 video_url
以上时长、画幅和任务方式为本平台调用规格，不将共享接口选项等同于型号原生能力上限。
核心能力
了解 grok-imagine-video:official 能为你的工作带来什么。
为已有图片补充动态
提供 image_url 后，可围绕静态画面设计运动，例如人物转身、物体旋转或环境细节变化。图片承担视觉起点，文字提示补充希望发生的动作与镜头变化。这种方式适合已有产品图、插画或概念图的项目，而非重新从文字定义全部画面。
把短片纳入任务流程
生成过程可以采用异步提交：先取得 task_id，再查询状态，或由完成回调接收结果。最终通过 video_url 获取视频，便于应用区分等待、成功和失败状态。它适合接入素材管理或创作界面，无需把提交请求与视频交付挤在同一步中。
适用场景
从具体任务出发，找到模型发挥作用的位置。
产品动态展示
以产品图片作为输入，描述希望呈现的运动、背景氛围和镜头变化，制作短小的展示素材。可先围绕单个卖点生成片段，再由剪辑环节组合成宣传内容。交付物是视频链接对应的片段，不是自动完成字幕、品牌排版与配音的整套广告。
社交内容创意验证
将内容主题写成具体场景，并按发布位置选择竖屏、横屏或方形画幅。围绕同一主题分别调整动作与镜头提示，获得可比较的短片方案。适合在正式制作前检查视觉表达是否成立，再挑选素材进入剪辑、文字包装与发布流程。
分镜与概念预演
把脚本中的一个镜头拆成主体、空间关系、动作和景别变化，使用文字生成初步预演；已有概念图时则用图生视频延展动态。结果可用于团队讨论镜头方向和节奏，但不应把独立生成的片段直接视作连续人物与场景完全一致的成片。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
需要两种创作起点时选择它
如果项目既会从文字构思，也会利用现成图片，grok-imagine-video:official 可以保留同一套短片工作流程。相比必须提供 image_url 的 grok-imagine-video-1.5:official，它允许没有图片时直接开始创作。选择重点是输入方式与任务范围，而不是仅凭版本名称判断所有能力。
按片段长度选择相关版本
本型号适合 1–15 秒的单镜头或短片段。若任务需要更长的单次生成，可考虑平台支持 6–30 秒的 grok-imagine-video-1.5-fast:reverse；若需要更短的动作测试，本型号也能覆盖。不同调用 ID 应分别配置参数，不要沿用另一版本的时长设置或默认型号。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 本型号的单次生成时长为 1–15 秒，不应因同一服务存在更长时长选项而提交超范围请求。多镜头故事宜拆成独立片段，再进行剪辑；分段生成也不意味着人物、服装与场景能够自动保持完全一致。
- 图生视频以图片链接作为输入，重点是从已有画面生成动态，不等同于对现有视频执行剪辑、续接或局部修改。制作时应将关键动作写清楚，并预留成片检查环节，不把文字描述视作精确的逐帧控制。
- fun、normal、spicy 不是该型号的风格开关；需要氛围变化时，应在提示词中描述视觉风格。视频交付也不等于自动完成配音、字幕和音轨制作，涉及声音或精确排版的任务应单独规划后期流程。
常见问题
解答使用 grok-imagine-video:official 时的常见疑问。
没有图片也能使用这个型号吗？
可以。文生视频只需提供描述内容的 prompt，并明确选择 grok-imagine-video:official。建议写清主体、动作、环境与镜头意图；如果已有图片，则可通过 image_url 转为图生视频，并用提示词补充运动要求。
它与 grok-imagine-video-1.5:official 有什么区别？
最直接的区别是创作起点：本型号同时支持文生视频和图生视频，而 grok-imagine-video-1.5:official 必须提供 image_url。若需要先用文字探索场景，本型号更合适；已有图片的任务则可按各自参数范围选择。
一次可以生成多长的视频？
本型号支持 1–15 秒的整数时长，默认 6 秒。适合单个动作、产品展示或分镜预演。更长的故事可以拆成片段后剪辑；需要单次生成更长片段时，可另选支持 6–30 秒的 grok-imagine-video-1.5-fast:reverse。
怎样选择横屏、竖屏或方形视频？
通过 aspect_ratio 设置画幅，可选择 16:9、9:16、1:1，以及 4:3、3:4、3:2、2:3。建议先按交付位置确定比例，再安排主体构图；使用图片时也应考虑原图构图与目标画幅的关系，避免关键内容贴近边缘。
异步提交后怎样拿到视频？
设置 async 为 true 后，保存返回的 task_id，并通过 POST /grok/tasks 查询结果；也可以配置 callback_url 接收完成通知。任务状态为 succeeded 时读取 video_url。不要仅凭获得任务 ID 就判断视频已经生成完成。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits
Official $0.30–$0.42−40%vs official
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.