影片
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 格計的格數:約 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 格的片段,以及從圖片開始,都不在此工作負載的服務範圍內。