Luma Ray 3.2 Text to Video API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | ray-3.2/text-to-video |
|---|---|
| 类型 | 视频生成（文生视频） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Luma Ray 3.2 文生视频：根据提示词生成 5 秒或 10 秒电影感短片，支持 540p、720p、1080p 和 6 种画面比例。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。
适用场景
电影感短片
用提示词描述场景、主体动作与镜头运动，直接生成视频。
prompt多平台画幅
横屏、竖屏、方形与超宽银幕 6 种画面比例，适配不同发布渠道。
aspect_ratio时长与清晰度
在 5 秒与 10 秒之间选择时长，在 540p、720p、1080p 之间选择清晰度。
durationresolution请求参数
model string 必填 固定填 ray-3.2/text-to-video。
input object 必填 业务参数对象；Luma Ray 3.2 Text to Video 的模型专属配置都放在这里。
prompt string 必填 描述要生成的视频画面、主体动作与镜头运动；长度 1–6000 个字符。
duration integer 可选 视频时长，单位为秒，可选 5 或 10。
resolution enum 可选 输出视频分辨率，可选 540p、720p、1080p。
aspect_ratio enum 可选 输出视频的画面比例，可选 16:9、9:16、1:1、4:3、3:4、21:9。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
风暴灯塔守望人
16:9、720p 的 5 秒文生视频示例。
请求体
{
"model": "ray-3.2/text-to-video",
"input": {
"prompt": "A lone lighthouse keeper climbs the spiral stairs at dusk, storm waves crash against the rocks below, the beam sweeps across the sea, slow cinematic crane shot",
"aspect_ratio": "16:9",
"duration": 5,
"resolution": "720p"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载生成的视频。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
可以设置哪些时长和画面比例?
duration 可选 5 或 10 秒；aspect_ratio 可选 16:9、9:16、1:1、4:3、3:4、21:9。
可以传入参考图片吗?
不可以。文生视频只接收文字提示词；如需以图片为首帧或尾帧，请使用 ray-3.2/image-to-video。
如何计费?
以 HiAPI 定价页的实时价格为准。 查看价格