LTX-2.3 文生视频 + 图生视频二合一:只传 prompt 即文生视频,带一张参考图(image)即图生视频,自动识别。支持 480p / 720p / 1080p、16:9 / 9:16。文生视频 5-15 秒,图生视频 5-20 秒。按秒计费。
没有单独的「图生视频」模型名。走哪条路只看请求里有没有 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://apimodels.app/api/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://apimodels.app/api/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。
按分辨率、按秒计:apimodels.app 上 480p $0.02/秒、720p $0.04/秒、1080p $0.045/秒。总价就是每秒价乘以你要的时长,720p 的 5 秒片子 $0.20,1080p 的 10 秒片子 $0.45。文生和图生同价——分辨率是唯一的价格档位——并且只有成功才扣费。
在同一个请求里加上 image 字段,填一张参考图的 URL 就行。没有单独的图生视频模型名:model 始终是 "ltx-2.3",带不带 image 决定走哪条路,系统自动识别;不传就是文生视频。只吃一张参考图,不是图片数组。
上限跟着模式走:文生视频 5-15 秒,图生视频 5-20 秒。用 duration 字段按秒指定,不传则用默认值。因为是按秒计费,时长越长价格线性增加——1080p 的 20 秒片子是 $0.90。
分辨率有 480p / 720p / 1080p(默认 720p),比例只有 16:9 和 9:16(默认 16:9),没有 1:1 或 4:3。1080p 比 720p 每秒只贵 $0.005,一条 10 秒片子也就差 5 美分,所以想要清晰度基本没必要停在 720p。
是异步的,和站上其它视频模型一致:POST /api/v1/video/generations 拿到 taskId,再轮询 GET /api/v1/video/generations?task_id=... ,等 state 变成 "completed" 后读 data.resultUrls[0];"failed" 表示任务已终止。也可以传 callback_url,任务完成时我们回调你的地址,完全省掉轮询。结果文件保留 7 天后自动删除,需要长期保存请及时下载或转存。