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.

注册领取免费额度
Developer Guides

相关开发者教程与指南

了解如何在实际生产中接入与应用 Grok Video 1.5。

View all posts