LTX 2.5 Fast 图生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | ltx-2.5-fast/image-to-video |
|---|---|
| 能力 | 首帧 / 首尾帧生视频 + 原生音频 |
| 分辨率 | 720p / 1080p |
| 时长 | 2-20 秒 |
上传首帧图，可再加一张尾帧，生成 2-20 秒的 720p 或 1080p 视频并配原生音频，按秒计费。
生产建议
调用建议
- aspect_ratio 尽量与首帧图片的画幅一致，避免画面被裁切或留边。
- 首尾帧模式下两张图的构图、机位尽量一致，过渡更自然。
- 使用 callback.url 接收任务完成或失败通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
- 产物 URL 有有效期，需要长期保存时请转存到自己的存储。
适用场景
静态图动起来
产品图、风景、插画加上运动与镜头。
image_urlsprompt首尾帧过渡
白天到夜晚、合上到打开，两张图之间自然过渡。
image_urls有声成片
同时生成环境声和音效，减少后期配音。
generate_audio请求参数
model string 必填 模型 ID。
input object 必填 图生视频参数。
prompt string 必填 描述要加入的运动、镜头和声音，不必重复画面内容。最多 5,000 字符。
image_urls string[] 必填 1-2 个以 http:// 或 https:// 开头的公网图片 URL（JPG/PNG/WebP）。第 1 张为首帧；传第 2 张时作为尾帧，视频从首帧过渡到尾帧。
resolution enum 可选 输出分辨率，决定每秒价格。
duration enum 可选 视频时长（秒），可选 2-6、8、10、12、14、16、18、20。按秒计费。
aspect_ratio enum 可选 横屏 16:9 或竖屏 9:16。
generate_audio boolean 可选 是否同时生成原生音频（环境声、音效、配乐）。不影响价格。
callback object 可选 任务完成或失败后发送通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
url string 必填 接收任务完成或失败通知的 HTTPS 地址。
when enum 可选 任务完成或失败时触发。
用例示例
首帧生视频
只传一张首帧。
请求体
{
"model": "ltx-2.5-fast/image-to-video",
"input": {
"prompt": "Waves crash against the rocks below the lighthouse, seagulls glide across the golden sky, the camera slowly pushes in, sound of surf and gulls",
"image_urls": [
"https://example.com/first-frame.jpg"
]
}
}首尾帧过渡
传两张图，第 2 张作为尾帧。
请求体
{
"model": "ltx-2.5-fast/image-to-video",
"input": {
"prompt": "Time passes from day to night, the windows light up, fixed camera",
"image_urls": [
"https://example.com/day.jpg",
"https://example.com/night.jpg"
],
"duration": 5
}
}获取结果
- 创建任务响应从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
- status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。
常见问题
尾帧是必须的吗？
不是。只传 1 张图时作为首帧；传 2 张时第 2 张作为尾帧。
输出画幅由什么决定？
由 aspect_ratio（16:9 或 9:16）决定，建议与首帧图片一致。
关闭 generate_audio 会更便宜吗？
不会。价格只由分辨率和时长决定。
支持哪些分辨率？
720p（默认）和 1080p。