跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Grok Imagine 1.5 Lite Image to Video API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 grok-imagine-1.5-lite/image-to-video
类型 视频生成（图生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Grok Imagine 1.5 Lite 图生视频：以一张图片生成 1–15 秒、480p 至 1080p 的视频，画面比例大致跟随输入图，并自带与画面匹配的音效。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

静图动画化

以已有图片为基础，加入主体运动、镜头推拉与环境氛围。

image_urlprompt
保持原图构图

构图沿用输入图片，画面比例大致跟随原图，无需额外设置比例。

image_url
分辨率分级

草稿用 480p，日常内容用 720p，高细节交付用 1080p。

resolution

请求参数

model string 必填

固定填 grok-imagine-1.5-lite/image-to-video。

示例 grok-imagine-1.5-lite/image-to-video
input object 必填

业务参数对象；本模型的专属配置都放在这里。

prompt string 必填

描述希望图片中发生的动态与镜头运动，无需复述图片已有内容；长度 1–4096 个字符。

image_url string 必填

要做成视频的图片的公开 URL，仅支持 1 张；输出视频的画面比例大致跟随这张图片（像素尺寸可能略有取整）。

duration integer 可选

视频时长，单位为秒；取值为 1–15 之间的整数。

默认 6
resolution enum 可选

输出视频分辨率，可选 480p、720p、1080p。

默认 720p 可选值: 480p720p1080p
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

冲浪者与翻卷的浪

图生视频示例：一张输入图、6 秒、720p。

请求体
{
  "model": "grok-imagine-1.5-lite/image-to-video",
  "input": {
    "prompt": "The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.",
    "image_url": "https://dev-static.hiapi.ai/model-onboarding/grok-imagine-1.5-lite/2026/10/16/1792144202117-54aa29a700fa9530-surf-in.png",
    "duration": 6,
    "resolution": "720p"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

输出视频的画面比例由什么决定?

大致跟随 image_url 图片的画面比例（像素尺寸可能略有取整），因此本模型没有 aspect_ratio 参数。

可以传多张图片吗?

不可以，image_url 只接受 1 张图片的公开 URL。

视频带声音吗?

带。生成的视频会同时包含与画面匹配的音效，无需额外参数。

提示词应该怎么写?

描述希望添加的运动与镜头即可，不必复述图片中已有的内容。

如何计费?

以 HiAPI 定价页的实时价格为准。 查看价格

下一步