用于参考图转视频的 Grok Imagine 1.5 API

通过 POST https://api.goenhance.ai/api/v1/videos/generations 使用 grok_imagine_1_5 将 1 到 7 张参考图转为动态视频。控制时长、分辨率和画面比例,然后通过任务 ID 或回调跟踪完成状态。
获取 API 密钥
电影感的参考图转视频场景:折纸狐狸在风吹草动中

使用 Grok Imagine 1.5 视频路由构建

风吹草地中的折纸狐狸,展示参考图引导的运动
暴风雨中的电影感帆船,展示可控的视频构图
提交前验证必填参考图、提示词长度、时长、分辨率和比例。

Grok Imagine 1.5 API 能力

精确的模型标识符

将 <code>model</code> 设置为 <code>grok_imagine_1_5</code>;请原样保留下划线。

提示词必填

发送最多 4,096 个字符的运动和场景提示词。

1 到 7 张参考图

必填的 <code>image_urls</code> 数组接受 1–7 个公开图片 URL。

已验证的媒体输入

每张参考图可以是 JPEG、PNG 或 WebP,最大 20 MB。

1 到 15 秒

选择 1 到 15 秒之间的整数时长。文档默认值为 8 秒。

两个输出档位

选择 480p 或 720p。文档默认值为 480p,支持六种比例值,包括 <code>auto</code>。
GoEnhance 按分辨率对生成时长计费;生产部署前请核实实时定价。

Grok Imagine 1.5 API 定价

480p 定价

480p 每生成一秒消耗 0.52 tokens,按每个 token $0.02 计算,相当于每秒 $0.0104。

720p 定价

720p 每生成一秒消耗 0.975 tokens,按每个 token $0.02 计算,相当于每秒 $0.0195。

计算每次请求的费用

将请求的时长乘以所选每秒费率。例如,8 秒在 480p 下消耗 4.16 tokens,在 720p 下消耗 7.8 tokens。

集成 Grok Imagine 1.5 API

1. 创建并妥善保管 API Key
1

1. 创建并妥善保管 API Key

创建 GoEnhance API 密钥,并从你的服务器在 Authorization 标头中发送;切勿将其暴露在浏览器代码中。
2. 托管已验证的参考图
2

2. 托管已验证的参考图

将 1–7 张受支持的参考图放到公网可访问的 URL 上,并在提交前确认格式、大小和访问权限。
3. 构建请求
3

3. 构建请求

设置 modelpromptimage_urls;并显式指定时长、分辨率、画面比例,以及可选的 HTTPS 回调 URL。
4. 提交并持久化任务 ID
4

4. 提交并持久化任务 ID

/api/v1/videos/generations 发起 POST 请求,检查 code,并幂等保存返回的 img_uuid
5. 轮询或接收回调
5

5. 轮询或接收回调

轮询 GET /api/v1/jobs/detail,或接收状态变更回调。文档规定,回调投递失败时重试最多三次,每次尝试超时三秒。
6. 处理终态结果
6

6. 处理终态结果

仅在成功后保存完成的视频资产;对失败或 token 不足的响应要如实上报,且不要将其当作可用的视频结果。
在需要源图一致性和 API 自动化的场景中,使用参考图驱动的视频生成。

开发者使用 Grok Imagine 1.5 构建了什么

产品动态短片

将已审核通过的产品渲染图生成为用于发布、目录或营销活动的短视频素材。

角色表演测试

基于一致的角色参考图,探索动作与表情表现。

故事板预演

将关键帧转化为动态样片,用于评估节奏、运镜和场景。

本地化营销活动变体

复用已审核通过的视觉参考,同时根据各地区的创意简报调整提示词。

社交媒体视频制作

为不同渠道的投放位创建竖屏、方形或横屏动态素材。

自动化创意流水线

在可重复的后端工作流中串联素材接入、请求校验、任务跟踪和结果交付。
端点、必需输入、定价、输出控制、完成处理以及平台关系。

Grok Imagine 1.5 API 常见问题

使用 Grok Imagine 1.5 开始构建

Grok Imagine 1.5 API:定价与集成 | GoEnhance Open API