동영상
LTX-2.5 동영상 생성기
소리가 있는 텍스트-동영상 변환 — LTX-2.5가 연결한 기기에서 프롬프트로 짧은 MP4를 만들어 줍니다.
API 레퍼런스
REST로 제출
개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.
https://cp.meshlabs.cloud/v1/organizations/jobsX-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 | 24fps 기준 클립 길이(프레임 수)입니다: 약 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
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 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프레임, 최대 약 5초, 384p부터 1088p까지, 가로형, 세로형 또는 정사각형의 MP4를 받을 수 있습니다. 임대한 GPU가 아니라 MESH에 연결한 컴퓨터에서 실행됩니다. 스케줄은 고정되어 있어 조정할 가이던스 스케일이나 네거티브 프롬프트가 없으며, 4K, 121프레임을 넘는 클립, 이미지에서 시작하는 방식은 이 워크로드가 제공하는 범위 밖입니다.