ToAPIs
home

快速结论

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

关键参数

  • model | string | 必填 | grok-video-1.0 | - | 模型标识，固定使用 `grok-video-1.0`。
  • prompt | string | 必填 | - | - | 描述目标视频的主体、动作、场景与风格。
  • aspect_ratio | string | 可选 | 16:9 | 1:1 | 16:9 | 9:16 | 3:2 | 2:3 | 视频画幅比例，默认 `16:9`；支持 `1:1 | 16:9 | 9:16 | 3:2 | 2:3`。
  • duration | integer | 可选 | 6 | 6 | 10 | 输出时长，单位秒；默认 `6`，支持 `6 | 10`。
  • resolution | string | 可选 | 720p | 480p | 720p | 输出分辨率；默认 `720p`，支持 `480p | 720p`。

常见错误

  • 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-video-1.0

grok-video-1.0 由 xAI 提供，覆盖 Video 能力。当前价格参考：2 积分 /second。该页面用于快速理解模型定位、参数要点与落地场景，再对接生产 API。

模型类型：
价格： 2 积分 /second

输入

表单JSON

参考图

描述主体、镜头、场景和风格。59 / 1200

高级选项

示例参数

输出

预览JSON

视频结果会显示在这里

视频生成通常需要更久，提交后请等待任务轮询完成。

查看 API 文档获取 API Key

生成需要一些时间，请稍等您可以离开此页面，[ 任务日志 ] 可直接检查生成的内容

请求预览

{
  "model": "grok-video-1.0",
  "prompt": "一支 6 秒产品概念短片，展示 grok-video-1.0 生成的未来感城市街景，镜头缓慢推进，光线自然，画面稳定。",
  "duration": 6,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

透明计价

grok-video-1.0 价格

Video usage is billed according to the current duration and resolution rules. Final billing follows the current account quote.

充值积分
2 积分 /second

为什么选择 ToAPIs

Why call grok-video-1.0 through ToAPIs?

Keep video generation, API keys, billing, and task tracking in one workflow.

多模式统一调试

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

参数可视化验证

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

生产迁移友好

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

Connect in three steps

Create a key, submit a video task, and poll the result.

  1. 1

    Step 1

    填写 Prompt 与关键参数。

  2. 2

    Step 2

    运行并观察输出结构，再按场景迭代参数。

  3. 3

    Step 3

    将稳定参数迁移到生产 API。

When to use grok-video-1.0

Use case 1

需要在多种视频生成模式之间快速做效果对比。

Use case 2

需要在接入前明确参数组合、输出稳定性和错误处理。

常见问题

grok-video-1.0 FAQ

grok-video-1.0 适合哪些场景？

适合快速验证视频创意、多模式对比参数效果、以及在接入 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 轮询状态，详细以对应文档为准。

grok-video-1.0 API

Start building with grok-video-1.0

Test a video request here, then continue in the dashboard or API documentation.

Start for freeView API Docs

Try grok-video-1.0 with one ToAPIs key.

Use one account and API surface for video generation workflows.

Sign up to get free credits