LTX 2.5 Fast 文生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | ltx-2.5-fast/text-to-video |
|---|---|
| 能力 | 文生视频 + 原生音频 |
| 分辨率 | 720p / 1080p |
| 时长 | 2-20 秒 |
用一段文字生成 2-20 秒的 720p 或 1080p 视频，支持横竖屏和原生音频，按秒计费。
生产建议
调用建议
- 先用 720p 和较短时长确认画面，再切到 1080p 或更长时长出成片。
- 需要竖屏短视频时设置 aspect_ratio=9:16。
- 使用 callback.url 接收任务完成或失败通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
- 产物 URL 有有效期，需要长期保存时请转存到自己的存储。
适用场景
广告与产品短片
一句话写清主体、动作和音效，快速得到可剪辑的镜头。
promptgenerate_audio竖屏社媒内容
9:16 直接生成竖屏，适合短视频平台。
aspect_ratio长镜头与分镜预览
最长 20 秒，适合连续动作和分镜预演。
durationresolution请求参数
model string 必填 模型 ID。
input object 必填 文生视频参数。
prompt string 必填 描述场景、主体动作、镜头和声音。最多 5,000 字符。
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 可选 任务完成或失败时触发。
用例示例
横屏有声短片
默认参数：720p、6 秒、16:9、原生音频。
请求体
{
"model": "ltx-2.5-fast/text-to-video",
"input": {
"prompt": "A barista pours steamed milk into a latte, creating a leaf pattern, close-up, soft morning light through a café window, gentle clinking cups and café ambience"
}
}1080p 竖屏
竖屏 1080p，4 秒。
请求体
{
"model": "ltx-2.5-fast/text-to-video",
"input": {
"prompt": "A skateboarder carves down an empty coastal road at sunset, tracking shot from behind",
"resolution": "1080p",
"aspect_ratio": "9:16",
"duration": 4
}
}获取结果
- 创建任务响应从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
- status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。
常见问题
支持哪些分辨率和时长？
720p 与 1080p 两档；时长 2-20 秒，可选 2、3、4、5、6、8、10、12、14、16、18、20 秒。
关闭 generate_audio 会更便宜吗？
不会。价格只由分辨率和时长决定，音频开关不参与计价。
可以用图片作为首帧吗？
可以，请使用 ltx-2.5-fast/image-to-video，并通过 image_urls 传入首帧（可选尾帧）。
帧率可以调吗？
固定为 25fps，无需传参。