Grok Imagine 1.5 Lite Text to Video API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | grok-imagine-1.5-lite/text-to-video |
|---|---|
| 类型 | 视频生成（文生视频） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Grok Imagine 1.5 Lite 文生视频：用文字生成 1–15 秒、480p 至 1080p 的视频，支持 7 种画面比例，并自带与画面匹配的音效。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。
适用场景
文字直出短视频
一段提示词写清主体、动作、镜头与声音，直接生成带音效的短片。
promptduration多平台画幅
横屏、方形与竖屏 7 种比例，适配不同发布平台。
aspect_ratio分辨率分级
草稿用 480p，日常内容用 720p，高细节交付用 1080p。
resolution请求参数
model string 必填 固定填 grok-imagine-1.5-lite/text-to-video。
input object 必填 业务参数对象；本模型的专属配置都放在这里。
prompt string 必填 描述画面内容、动作、镜头运动与声音；长度 1–4096 个字符。
duration integer 可选 视频时长，单位为秒；取值为 1–15 之间的整数。
resolution enum 可选 输出视频分辨率，可选 480p、720p、1080p。
aspect_ratio enum 可选 输出视频画面比例，可选 16:9、4:3、3:2、1:1、2:3、3:4、9:16。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
日出梯田上的玻璃热气球
文生视频示例：6 秒、720p、16:9。
请求体
{
"model": "grok-imagine-1.5-lite/text-to-video",
"input": {
"prompt": "A glass hot-air balloon drifts slowly over a misty valley of terraced rice fields at sunrise. Golden light spills across the water-filled terraces, mist rolls between the hills, a flock of white egrets glides beneath the balloon. Smooth aerial tracking shot, gentle wind sounds and distant birdsong, cinematic, natural colors. No text, no logos.",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载生成的视频。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
支持哪些画面比例?
16:9、4:3、3:2、1:1、2:3、3:4、9:16，默认 16:9。
视频带声音吗?
带。生成的视频会同时包含与画面匹配的音效，无需额外参数。
提示词应该怎么写?
把主体、场景、动作、镜头运动与声音写在一段话里，描述一个清晰的镜头效果更好。
如何计费?
以 HiAPI 定价页的实时价格为准。 查看价格