ToAPIs
home

快速结论

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

关键参数

  • model | string | 必填 | grok-video-1.5 | - | 模型标识，固定使用 `grok-video-1.5`。
  • 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 | 可选 | 10 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 输出时长，单位秒；默认 `10`，支持 `1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`。
  • 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 次，持续失败请升级人工排查。
xAI logo

Grok Video 1.5

可商用

可请求文生视频, 单首帧图生视频或参考图生视频. 可用模式和时长取决于渠道支持范围.

模型类型：
价格： Grok Video 1.5 最低 ¥0.0714/s
480p ¥0.0714/s· 720p ¥0.1338/s

输入

表单JSON

首帧图

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

高级选项

示例参数

输出

预览JSON
查看 API 文档获取 API Key

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

请求预览

{
  "model": "grok-video-1.5",
  "prompt": "(0-5s) Medium shot, she speaks warmly while gesturing to a product. (5-10s) Slow push-in to a close-up, glowing skin and expressive eyes. (10-15s) Cut to an over-shoulder framing of the vanity as she smiles. Glossy, warm, cinematic.",
  "duration": 10,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "video_generation_mode": "first_frame_image_to_video",
  "_error": "__i18n:errors.grokVideo15NeedsImage"
}

1

首图

1–15s

时长

Live

计费

API

可接入生产

生成案例

探索 Grok Video 1.5 的生成效果

使用同款模型生成

15 秒图生视频结果

补充 15 秒动态示例

第二个 15 秒动态示例

透明计价

grok-video-1.5 价格

当前 ToAPIs 价格与定价页同源，按线上报价规则展示。最终计费取决于分辨率与生成时长。

充值积分

480p

ToAPIs

¥0.0714

2.04 积分 / 秒

720p

ToAPIs

¥0.1338

3.82 积分 / 秒

价格与当前 /pricing 页 grok-video-1.5 报价一致。最终计费以账户当前价格、分辨率和时长为准。

为什么选择 ToAPIs

为什么用 ToAPIs 调用 Grok Video 1.5？

一个 API Key 覆盖图生视频、价格查询、异步轮询和更多模型路由。

明确选择生成模式

区分文生视频, 单首帧图生视频和参考图生视频. 不同渠道对单张图片的实现可能不同.

按秒价格清晰

任务按每生成一秒 $0.01 计费，提交前按账户价格确认。

统一视频工作流

提交视频任务、轮询状态，并在同一控制台管理 Sora、VEO、Kling、Seedance 和 Grok。

三步生成 Grok 视频

先在浏览器测试动态效果，再把同样请求结构接入生产。

  1. 1

    选择模式和图片

    文生视频无需图片, 单首帧模式使用 1 张图, 参考图模式使用 1-7 张图. 支持 JPEG, PNG 和 WebP.

  2. 2

    选择时长和画幅

    描述所需动态效果，然后选择 1–15 秒、分辨率和宽高比。

  3. 3

    轮询任务状态

    使用返回的任务 ID 查询视频任务状态，直到生成视频 URL 可用。

适合现代视频创作团队

产品动态测试

把产品静态图生成短视频，用于广告、电商列表和新品页面。

分镜验证

把已确认画面转成短动态草稿，再进入更长视频生产。

创作者工作流

批量测试图片概念，只保留符合活动需求的动态候选。

常见问题

Grok Video 1.5 常见问题

Grok Video 1.5 支持文生视频吗？

渠道开放后可以使用. 选择文生视频并发送提示词, 无需图片. 并非所有渠道都已开放新模式.

可以同时使用首帧和参考图吗?

渠道开放组合能力后可以. 选择首帧 + 参考图生视频, 提供 1 张首帧和 1-7 张参考图, 使用 480p 或 720p. 首帧与参考图保留各自角色, 是否可用取决于渠道.

可以上传几张参考图？

参考图模式支持 1-7 张图片和 480p 或 720p, 具体以渠道配置为准. 即使只有 1 张参考图, 也需将 video_generation_mode 设为 reference_images_to_video.

支持哪些时长？

Grok Video 1.5 支持 1–15 秒，最终按每生成一秒 $0.01 计费。

Grok Video 1.5 API

创建你的第一个 Grok 视频任务

先用免费额度验证动态效果，再把 API 接入你的创意生产流程。

免费开始查看 API 文档

新用户注册即可领取 10 credits，试用 Grok Video 1.5。

选择生成模式, 输入提示词并上传该模式需要的图片, 先验证效果再接入 API.

注册领取免费额度