Grok Imagine 1.5 Image to Video (Preview) API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

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

xAI Grok Imagine 1.5(预览版)图生视频:静图动画化,运动质量较 1.0 升级,1-15 秒灵活时长,480p/720p 按秒计费,与 1.0 同价。

生产建议

生产环境建议

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

适用场景

静图动画化升级档

较 1.0 运动质量明显升级:动作更连贯、镜头更稳,同价切换零成本。

image_urlsprompt

1-15 秒灵活时长

时长从固定档变为任意整数秒,按秒计费,短平快验证创意或出长镜头都合适。

duration

低成本迭代

480p 档单价极低,先低清跑创意再 720p 出成片。

resolution

跟随输入图画幅

aspect_ratio 默认 auto 自动跟随输入图,竖图横图都不裁切变形。

aspect_ratio

请求参数

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

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-1.5/image-to-video",
  "route": "preview",
  "input": {
    "prompt": "The giant jellyfish slowly pulses and drifts upward, its lace tentacles flowing gracefully, the school of silver fish spirals around it, gentle cinematic push-in, smooth natural motion, consistent lighting across frames",
    "image_urls": [
      "https://static.hiapi.ai/previews/nano-banana-2-lite/2026/07/03/1783076311460-2afd2d0092234bc7-nano-lite-cover.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 6
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "grok-imagine-1.5/image-to-video",
  "route": "preview",
  "input": {
    "prompt": "The giant jellyfish slowly pulses and drifts upward, its lace tentacles flowing gracefully, the school of silver fish spirals around it, gentle cinematic push-in, smooth natural motion, consistent lighting across frames",
    "image_urls": [
      "https://static.hiapi.ai/previews/nano-banana-2-lite/2026/07/03/1783076311460-2afd2d0092234bc7-nano-lite-cover.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 6
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "grok-imagine-1.5/image-to-video",
  "route": "preview",
  "input": {
    "prompt": "The giant jellyfish slowly pulses and drifts upward, its lace tentacles flowing gracefully, the school of silver fish spirals around it, gentle cinematic push-in, smooth natural motion, consistent lighting across frames",
    "image_urls": [
      "https://static.hiapi.ai/previews/nano-banana-2-lite/2026/07/03/1783076311460-2afd2d0092234bc7-nano-lite-cover.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 6
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

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

示例 grok-imagine-1.5/image-to-video@preview

input object 必填

业务参数对象；Grok Imagine 1.5 Image to Video (Preview) 的模型专属配置都放在这里。

prompt string 可选

可选运动描述提示词(英文效果最佳),最长 4096 字符。

image_urls string[] 必填

要动画化的输入图 URL(固定 1 张);JPEG/PNG/WebP ≤20MB。

aspect_ratio enum 可选

输出视频画幅;auto 跟随输入图。

默认 auto 可选值: auto1:116:99:163:22:3

resolution enum 可选

输出分辨率;720p 每秒单价更高。

默认 480p 可选值: 480p720p

duration integer 可选

视频时长 1-15 秒(整数);费用随时长线性增长。

默认 8

callback object 可选

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

url string 必填

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

示例 https://your-domain.com/hiapi/callback

when enum 可选

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

默认 final 可选值: final

用例示例

深海水母巡游(720p/6s)

成片档,验证运动质量与光影一致性。

请求体

{
  "model": "grok-imagine-1.5/image-to-video",
  "route": "preview",
  "input": {
    "prompt": "巨大的水母缓缓脉动上浮,蕾丝状触手优雅流动,银色鱼群绕其盘旋,镜头缓推,平滑自然运动,帧间光影一致",
    "image_urls": [
      "https://static.hiapi.ai/previews/nano-banana-2-lite/2026/07/03/1783076311460-2afd2d0092234bc7-nano-lite-cover.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 6
  }
}

沙漠营地推镜(480p 迭代档)

最低成本验证运动创意。

请求体

{
  "model": "grok-imagine-1.5/image-to-video",
  "route": "preview",
  "input": {
    "prompt": "镜头贴着沙脊缓缓推向发光的帐篷,流星淡出,星光轻闪,帐篷内灯光微微摇曳,平滑自然运动",
    "image_urls": [
      "https://static.hiapi.ai/previews/nano-banana-2-lite/2026/07/03/1783076316176-b9c9c7b278a01155-nano-lite-g2-desert.webp"
    ],
    "aspect_ratio": "auto",
    "resolution": "480p",
    "duration": 6
  }
}

获取结果

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

常见问题

1.5 preview 和 grok-imagine 1.0 有什么区别?

1.5 是 xAI 的升级预览版:运动质量明显更好,时长从固定档变为 1-15 秒任意整数,单价与 1.0 相同。preview 意味着上游可能随正式版微调行为,正式版发布后我们会平滑切换。

怎么计费?

按秒计费,480p 与 720p 两档单价不同,总价 = 每秒单价 × duration。实时价格见价格页。查看价格

提示词怎么写运动效果最稳?

一条提示词写一个清晰、单一的运动(如「镜头缓推」「种子飘向镜头」),英文效果最佳;避免同时叠加多个互相冲突的运动指令。

怎么拿到生成的视频?

提交后立即返回 taskId,任务进入终态后从 output[].url 下载视频。生产环境建议在请求体顶层传 callback.url 收终态通知,减少无效轮询。