视频
LTX-2.5 视频生成器
带声音的文生视频:LTX-2.5 在您连接的设备上根据提示词生成简短的 MP4。
API 参考
通过 REST 提交
使用您的个人 API 密钥(msk_…),从您自己的工具为此工作负载创建任务。以这种方式启动的任务会在您于您的设备中连接的同一批设备上运行——至少需要有一台在线。
POST
https://cp.meshlabs.cloud/v1/organizations/jobs使用 X-Organization-Api-Key: msk_your_personal_api_key 进行身份验证。该请求头名称与组织密钥相同;个人密钥使用相同的端点。
请求体
{
"workload_type": "ltx25-22b-distilled-gguf",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"enable_audio": true,
"resolution": "576p",
"aspect_ratio": "16:9",
"num_frames": 33,
"fps": 24,
"keep_warm": false
}
}job_spec 字段
| 字段 | 必填 | 默认值 | 说明 |
|---|---|---|---|
prompt | 是 | — | 片段中发生的事:主体、动作、场景和镜头,以及应听到什么。 |
enable_audio | 否 | true | 随画面一起生成的配乐,混入 MP4。 |
resolution | 否 | 576p | 画面尺寸。默认 576p;最大为 1088p。 |
aspect_ratio | 否 | 16:9 | 画幅。 |
num_frames | 否 | 33 | 片段长度,以 24 fps 的帧数计:约 1.4、2.7、4 或 5 秒。 |
seed | 否 | — | 随机种子。相同的种子和提示词会得到相同的片段。 |
keep_warm | 否 | false | 为下一个片段,把模型保留加载在您的设备上。 |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "ltx25-22b-distilled-gguf",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"enable_audio": true,
"resolution": "576p",
"aspect_ratio": "16:9",
"num_frames": 33,
"fps": 24,
"keep_warm": false
}
}'GET
https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}使用同一 API 密钥轮询,直到 status 进入终态(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。启用内容审核时,任务可能会先处于 MODERATION_PENDING 状态,然后才进入计算队列。已完成的任务会在每个输出上包含预签名的 download_url 值。
创建响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ltx25-22b-distilled-gguf",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"enable_audio": true,
"resolution": "576p",
"aspect_ratio": "16:9",
"num_frames": 33,
"fps": 24,
"keep_warm": false
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}完成响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ltx25-22b-distilled-gguf",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"enable_audio": true,
"resolution": "576p",
"aspect_ratio": "16:9",
"num_frames": 33,
"fps": 24,
"keep_warm": false
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}一句话生成视频。LTX-2.5 是 Lightricks 的开放权重视频模型;此工作负载运行其蒸馏版 22B 检查点,画面和配乐一起生成。您会得到每秒 24 帧、最长约五秒的 MP4,分辨率从 384p 到 1088p,可选横屏、竖屏或方形。它运行在您连接到 MESH 的电脑上,而不是租用的 GPU 上。调度固定:没有引导系数,也没有负面提示词可调;4K、超过 121 帧的片段以及以图片起步,都不在此工作负载的服务范围内。