LTX 2.5 Fast 文生视频 API 怎么用？5 分钟出第一条

TL;DR

• LTX 2.5 Fast Text to Video（ltx-2.5-fast/text-to-video）把一段文字变成 2–20 秒的视频，720p / 1080p、横竖屏、原生音频一起出。打开模型页就能试，新用户注册送 200 积分。
• 价格按秒算：720p 每秒 $0.043（6 秒一条 $0.258），1080p 每秒 $0.086；generate_audio 开关不影响价格。
• 调用走 HiAPI /v1/tasks 接口：提交任务拿 taskId，再查询结果，成功后从 output 里取视频地址（临时地址，及时保存）。

它能做什么

• 一句话出有声镜头：场景、运动、镜头和声音写进同一条提示词，音频跟画面一起生成。
• 2–20 秒、12 档时长：duration 取 2、3、4、5、6、8、10、12、14、16、18、20，默认 6 秒。
• 横竖屏和两档分辨率：16:9 / 9:16，720p / 1080p；帧率固定 25fps MP4。
• 同系列还有图生视频：ltx-2.5-fast/image-to-video 上传首帧（可加尾帧）让静态图动起来，价格规则一样，见图生视频模型页。

两个接口怎么选：

一句话：画面内容定不下来用文生，画面已经有了用图生；两个接口可以串——文生出定稿首帧，再交给图生加运镜。

下面是真实成片（720p · 6 秒，带原生音频）：

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

（中文意思：咖啡师把蒸汽奶倒进拿铁，拉出叶子图案，特写，晨光透过咖啡馆窗户，杯碟轻响与咖啡馆环境声。参数用默认：720p、6 秒、16:9、开音频。）

视频封面帧

ltx-2.5-fast/text-to-video，720p，6 秒，16:9，1280×720，有声，$0.258。看完整成片 →

用这个提示词生成 →

两条上手路线

浏览器 3 步：打开模型页 → 粘贴提示词、选时长和分辨率 → 点生成，720p 6 秒一条 $0.258，出片之后直接在线预览。

API 3 步：POST /v1/tasks 提交 → 拿 taskId → GET /v1/tasks/<taskId> 查到 success 后下载。

curl：第一条

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "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",
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

这条 720p × 6 秒是 $0.258。

Python：提交、轮询、下载

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "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",
        "resolution": "720p",
        "duration": 6,
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    video_url = video["url"]   # 临时地址，尽快下载保存
    mp4 = requests.get(video_url, timeout=120)
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

参数表

请求体里出现表外字段会直接 400。

你会遇到的报错

任务终态失败还有 CONTENT_POLICY_VIOLATION、TASK_FAILED、TASK_TIMEOUT 等；失败不扣费。

上线前注意

• 回调：请求体顶层传 "callback": {"url": "https://..."}，终态自动通知，视频任务耗时长，建议用。
• 及时转存：output 里的视频地址是临时的，拿到就下载。
• 显式写 duration 和 resolution：这两个字段决定账单，别依赖默认值；上线前把这两个值打进日志，对账时一目了然。
• 批量的节奏：一条 6 秒视频从提交到出片要等一会儿，批量任务建议排队提交 + 回调收结果，不要同步死等。
• 要静态图动起来：用同系列的图生视频模型页，上传首帧更可控。

常见问题

• 是的，音频跟视频一起出：generate_audio 默认开；提示词里把声音写出来（风声、杯碟轻响），音频会更贴画面。
• 是的，时长只有 12 档：2 到 20 秒之间的枚举值，7 秒、9 秒这种传了会 400。
• 是的，价格 = 每秒价 × 秒数：720p 6 秒 $0.258、1080p 6 秒 $0.516；关音频不便宜。
• 是的，$10 能出约 38 条：720p 6 秒一条算。
• 是的，竖版就是选 9:16：输出 720×1280（720p）或 1080×1920（1080p），发短视频平台不用再裁。
• 是的，分辨率建议先低后高：调提示词和构图用 720p，定了再升 1080p 重跑同一条提示词，每秒价差一倍但成品只有一条。
• 是的，音频关了不省钱：要后期配音配乐就传 generate_audio: false，拿干净画面。

下一步：拿拉花提示词去模型页出第一条，四个场景模板看文生视频提示词大全。