ToAPIs

快速结论

  • Grok Imagine 1 0 Video 在单页中覆盖 Text-to-Video、Image-to-Video、R2V、Video Edit 四种流程。
  • 页面支持参数对比与最小请求样例，便于快速验证和接口对接。
  • 建议先在本页收敛参数，再迁移到生产 API。

关键参数

  • model | string | 必填 | grok-imagine-1-0-video | - | 模型标识，必须使用 API 真值。
  • mode | enum | 必填 | text-to-video | text-to-video | image-to-video | r2v | video-edit | 指定生成/编辑模式。
  • input.prompt | string | 必填 | - | - | 描述目标视频内容与风格。
  • input.duration | integer | 可选 | 5 | 2-15 | 输出时长（秒）。
  • input.seed | integer | 可选 | - | >=0 | 用于增强结果复现性。

常见错误

  • 400 invalid_request_error: 触发=请求体缺少必填字段或字段类型不匹配。; 修复=校验 model、mode、input 的字段完整性与类型。; 重试=修正参数后重试，不建议直接盲重试。
  • 401 authentication_error: 触发=缺少 Authorization 头或 API Key 无效。; 修复=确认 Bearer Token 与密钥权限范围。; 重试=修复鉴权后重试；连续失败请轮换密钥。
  • 429 rate_limit_exceeded: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议指数退避（例如 1s/2s/4s）+ 抖动；连续触发时再收紧提交节奏。
  • 500 internal_error: 触发=上游服务瞬时异常或内部处理失败。; 修复=记录 request id 并触发重试链路。; 重试=可短间隔重试 2-3 次，持续失败请升级人工排查。
返回模型广场

模型解析页

Grok Imagine 1 0 Video

模型 ID: grok-imagine-1-0-video

厂商: xAI能力类型: Video价格: Input $0.00/1M, Output $0.00/1M更新于: 2026-05-02

Grok Imagine 1 0 Video 由 xAI 提供，覆盖 Video 能力。当前价格参考：Input $0.00/1M, Output $0.00/1M。该页面用于快速理解模型定位、参数要点与落地场景，再对接生产 API。

在 Playground 中打开文档

模型概览

快速结论

  • Grok Imagine 1 0 Video 在单页中覆盖 Text-to-Video、Image-to-Video、R2V、Video Edit 四种流程。
  • 页面支持参数对比与最小请求样例，便于快速验证和接口对接。
  • 建议先在本页收敛参数，再迁移到生产 API。

Grok Imagine 1 0 Video模型特点

核心能力

能力一览与工程实践价值

多模式统一调试

在一个页面内切换 Text-to-Video、Image-to-Video、R2V、Video Edit，快速比较效果。

参数可视化验证

围绕 prompt、时长、参考素材等关键参数做快速迭代，降低试错成本。

生产迁移友好

提供最小请求与响应结构，便于把验证过的参数直接迁移到正式 API。

如何使用 Grok Imagine 1 0 Video API

  1. 选择模式（Text-to-Video / Image-to-Video / R2V / Video Edit）。
  2. 填写 Prompt、参考素材与关键参数。
  3. 运行并观察输出结构，再按场景迭代参数。
  4. 将稳定参数迁移到生产 API。
Grok Imagine 1 0 Video

适用场景

  • 需要在多种视频生成模式之间快速做效果对比。
  • 需要在接入前明确参数组合、输出稳定性和错误处理。

API 运行特性

  • 当前模型解析页用于交互验证与参数预演。
  • 运行结果区域显示示例结构，用于说明任务状态字段。
Grok Imagine 1 0 Video

关键参数

参数类型必填默认值取值范围说明
modelstring是grok-imagine-1-0-video-模型标识，必须使用 API 真值。
modeenum是text-to-videotext-to-video | image-to-video | r2v | video-edit指定生成/编辑模式。
input.promptstring是--描述目标视频内容与风格。
input.durationinteger否52-15输出时长（秒）。
input.seedinteger否->=0用于增强结果复现性。

常见错误

400 invalid_request_error

触发条件: 请求体缺少必填字段或字段类型不匹配。

修复建议: 校验 model、mode、input 的字段完整性与类型。

重试策略: 修正参数后重试，不建议直接盲重试。

401 authentication_error

触发条件: 缺少 Authorization 头或 API Key 无效。

修复建议: 确认 Bearer Token 与密钥权限范围。

重试策略: 修复鉴权后重试；连续失败请轮换密钥。

429 rate_limit_exceeded

触发条件: 请求频率、并发或当前额度命中上游限流策略。

修复建议: 先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。

重试策略: 建议指数退避（例如 1s/2s/4s）+ 抖动；连续触发时再收紧提交节奏。

500 internal_error

触发条件: 上游服务瞬时异常或内部处理失败。

修复建议: 记录 request id 并触发重试链路。

重试策略: 可短间隔重试 2-3 次，持续失败请升级人工排查。

Grok Imagine 1 0 Video

FAQ

Grok Imagine 1 0 Video 适合哪些场景？

适合快速验证视频创意、多模式对比参数效果、以及在接入 API 前完成提示词与参数收敛。

Text-to-Video 和 Image-to-Video 怎么选？

只有文字脚本时优先 Text-to-Video；已有构图或关键画面时优先 Image-to-Video。

R2V 与 Video Edit 有什么区别？

R2V 更偏向参考素材驱动的新生成；Video Edit 更偏向在已有视频上做修改和增强。

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

模式说明

Text to Video 模式（Grok Imagine 1 0 Video）

从文字生成视频，适合从脚本到可视化首稿。

模式参数

promptnegative_promptdurationratioseed

最佳应用场景

  • 广告脚本预演
  • 分镜首稿生成
  • 社媒内容快速打样

Image to Video 模式（Grok Imagine 1 0 Video）

基于静态图驱动动作与镜头变化。

模式参数

image_urlpromptdurationcamera_motionstrength

最佳应用场景

  • 商品图动效
  • 角色照片动画化
  • 海报视频化

R2V 模式（Grok Imagine 1 0 Video）

参考素材驱动，强调风格与主体一致性。

模式参数

reference_urlpromptstrengthdurationseed

最佳应用场景

  • 品牌风格统一
  • 角色一致性生成
  • 多镜头风格延续

Video Edit 模式（Grok Imagine 1 0 Video）

在已有视频上进行风格和内容编辑。

模式参数

video_urlinstructiondurationedit_regionoutput_quality

最佳应用场景

  • 风格迁移
  • 局部改写
  • 后期增强

相关 API

准备开始统一接入 AI 模型了吗？

免费注册后，你可以先看模型广场选模型，再到定价页确认成本和默认路由策略

免费开始查看定价