apimodels.app

LTX-2.3 视频 API

Lightricks

LTX-2.3 文生视频 + 图生视频二合一:只传 prompt 即文生视频,带一张参考图(image)即图生视频,自动识别。支持 480p / 720p / 1080p、16:9 / 9:16。文生视频 5-15 秒,图生视频 5-20 秒。按秒计费。

一个 slug,两种模式

没有单独的「图生视频」模型名。走哪条路只看请求里有没有 image 字段,不需要另外声明。

模式	怎么触发	时长范围
文生视频	只传 prompt,不带 image	5-15s
图生视频	带一张参考图 image(URL)	5-20s

模型

名称	API 名	时长	价格
LTX-2.3 Video	ltx-2.3	5-20s	480p $0.02/s · 720p $0.04/s · 1080p $0.045/s

文生 + 图生(传图自动切换)

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点,与其它视频模型一致。

# Text-to-video (no image). Add "image" to switch to image-to-video.
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ltx-2.3",
    "prompt": "a drone shot flying fast over a neon city at night, cinematic",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

# Image-to-video: add an image URL (duration up to 20s)
#   "image": "https://your-domain.com/ref.png"

# Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

轮询到 state 变成 "completed" 时,data.resultUrls[0] 就是成片地址;"failed" 则任务结束、不再变化。

请求参数

字段	必填	类型	说明
model	是	string	"ltx-2.3"
prompt	是	string	画面 / 动作 / 镜头描述
image	否	string	参考图 URL。传入则走图生视频(否则文生视频)
resolution	否	string	480p / 720p / 1080p(默认 720p)
aspect_ratio	否	string	16:9 / 9:16(默认 16:9)
duration	否	number	秒数:文生 5-15,图生 5-20
callback_url	否	string	任务完成后的回调 URL

计费

计费 = 分辨率对应的每秒价 × 时长。分辨率是唯一的价格档位,文生和图生同价。

分辨率	每秒	5 秒	10 秒	20 秒(仅图生)
480p	$0.02	$0.10	$0.20	$0.40
720p(默认)	$0.04	$0.20	$0.40	$0.80
1080p	$0.045	$0.225	$0.45	$0.90

表里的秒数总价由每秒价直接相乘得出。1080p 与 720p 只差 $0.005/秒,一条 10 秒片子差 $0.05 —— 想要清晰度基本没有必要停在 720p。

要点与限制

异步接口:创建任务 + 轮询,与其它视频模型一致;也可以传 callback_url 让任务完成时回调,省掉轮询。
一个 slug 两用:不传 image 是文生视频,传 image 是图生视频 —— model 始终是 "ltx-2.3"。
图生视频只吃一张参考图,不是图片数组。
时长上限跟着模式走:文生最长 15 秒,图生最长 20 秒。
比例只有 16:9 和 9:16 两种,没有其它可选值。
调用成功才扣费,失败不扣。
结果文件保留 30 天后自动删除,需要长期保存请及时下载或转存。

常见问题

LTX-2.3 视频 API 多少钱?

按分辨率、按秒计:apimodels.app 上 480p $0.02/秒、720p $0.04/秒、1080p $0.045/秒。总价就是每秒价乘以你要的时长,720p 的 5 秒片子 $0.20,1080p 的 10 秒片子 $0.45。文生和图生同价——分辨率是唯一的价格档位——并且只有成功才扣费。

LTX-2.3 怎么做图生视频?

在同一个请求里加上 image 字段,填一张参考图的 URL 就行。没有单独的图生视频模型名:model 始终是 "ltx-2.3",带不带 image 决定走哪条路,系统自动识别;不传就是文生视频。只吃一张参考图,不是图片数组。

LTX-2.3 最长能生成多少秒?

上限跟着模式走:文生视频 5-15 秒,图生视频 5-20 秒。用 duration 字段按秒指定,不传则用默认值。因为是按秒计费,时长越长价格线性增加——1080p 的 20 秒片子是 $0.90。

LTX-2.3 支持哪些分辨率和画面比例?

分辨率有 480p / 720p / 1080p(默认 720p),比例只有 16:9 和 9:16(默认 16:9),没有 1:1 或 4:3。1080p 比 720p 每秒只贵 $0.005,一条 10 秒片子也就差 5 美分,所以想要清晰度基本没必要停在 720p。

LTX-2.3 接口是同步的吗?成片怎么拿?

是异步的,和站上其它视频模型一致:POST /api/v1/video/generations 拿到 taskId,再轮询 GET /api/v1/video/generations?task_id=... ,等 state 变成 "completed" 后读 data.resultUrls[0];"failed" 表示任务已终止。也可以传 callback_url,任务完成时我们回调你的地址,完全省掉轮询。结果文件保留 30 天后自动删除,需要长期保存请及时下载或转存。

本页涉及的模型

LTX-2.3 视频 · $0.02/s+