Ltx LTX 2 API | 요금 및 문서

ltx/ltx-2/fast/text-to-video

텍스트로 16:9 동영상을 만들고 길이, 해상도, 프레임률, 오디오 생성 여부를 지정합니다.

1. 시작하기

RunComfy API로 ltx/ltx-2/fast/text-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2/fast/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
  }'

2. 인증

환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2/fast/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "생성할 영상의 장면, 피사체, 동작, 카메라 연출, 시각적 스타일, 오디오 의도를 설명하는 텍스트입니다.",
      "type": "string",
      "default": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
    },
    "duration": {
      "title": "길이",
      "description": "생성 영상의 길이(초)입니다. 6, 8, 10, 12, 14, 16, 18, 20을 선택할 수 있습니다. 10초를 넘는 12, 14, 16, 18, 20은 25 FPS와 1080p 조합에서만 지원됩니다.",
      "type": "integer",
      "enum": [
        6,
        8,
        10,
        12,
        14,
        16,
        18,
        20
      ],
      "default": 6
    },
    "resolution": {
      "title": "해상도",
      "description": "생성 영상의 해상도입니다. 1080p, 1440p, 2160p를 선택할 수 있습니다.",
      "type": "string",
      "enum": [
        "1080p",
        "1440p",
        "2160p"
      ],
      "default": "1080p"
    },
    "aspect_ratio": {
      "title": "화면 비율(너비:높이)",
      "description": "생성 영상의 화면 비율입니다. 16:9만 지원됩니다.",
      "type": "string",
      "enum": [
        "16:9"
      ],
      "default": "16:9"
    },
    "fps": {
      "title": "초당 프레임",
      "description": "생성 영상의 프레임률입니다. 25 또는 50 FPS를 선택할 수 있습니다.",
      "type": "integer",
      "enum": [
        25,
        50
      ],
      "default": 25
    },
    "generate_audio": {
      "title": "오디오 생성",
      "description": "영상과 함께 오디오를 생성할지 지정합니다. 기본값은 true입니다.",
      "type": "boolean",
      "default": true
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.

1. 시작하기

RunComfy API로 ltx/ltx-2/fast/text-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2/fast/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
  }'

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2/fast/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "생성할 영상의 장면, 피사체, 동작, 카메라 연출, 시각적 스타일, 오디오 의도를 설명하는 텍스트입니다.",
      "type": "string",
      "default": "A photorealistic portrait of a stylish young woman sitting at an outdoor Parisian café with red woven bistro chairs and circular white tables. She has long, smooth, straight, honey-blonde hair, parted neatly in the middle. She is wearing a classic black beret, a crisp white button-up shirt, and a dark blue tie with diagonal gold stripes. Over her shirt, she wears a slightly oversized black leather jacket. She accessorizes with pearl and gold hoop earrings on one ear. Her makeup features sharp, winged eyeliner, defined eyebrows, and a natural nude lip color, giving her a chic, confident look. The scene captures a soft afternoon ambient light, with clear reflections on the glass window behind her. Through the window, vintage-style golden lettering that reads \"ROYH...\" is visible, partially cut off due to her posture. In the background, a Parisian street is subtly mirrored in the glass. The camera angle is eye-level, front-facing and slightly to the right, creating a natural, elegant composition. The color palette is warm and clean with a touch of Parisian café ambience. Extremely detailed, 8k resolution, sharp focus, shallow depth of field, photorealistic style, natural lighting, cinematic atmosphere, high fashion editorial aesthetic."
    },
    "duration": {
      "title": "길이",
      "description": "생성 영상의 길이(초)입니다. 6, 8, 10, 12, 14, 16, 18, 20을 선택할 수 있습니다. 10초를 넘는 12, 14, 16, 18, 20은 25 FPS와 1080p 조합에서만 지원됩니다.",
      "type": "integer",
      "enum": [
        6,
        8,
        10,
        12,
        14,
        16,
        18,
        20
      ],
      "default": 6
    },
    "resolution": {
      "title": "해상도",
      "description": "생성 영상의 해상도입니다. 1080p, 1440p, 2160p를 선택할 수 있습니다.",
      "type": "string",
      "enum": [
        "1080p",
        "1440p",
        "2160p"
      ],
      "default": "1080p"
    },
    "aspect_ratio": {
      "title": "화면 비율(너비:높이)",
      "description": "생성 영상의 화면 비율입니다. 16:9만 지원됩니다.",
      "type": "string",
      "enum": [
        "16:9"
      ],
      "default": "16:9"
    },
    "fps": {
      "title": "초당 프레임",
      "description": "생성 영상의 프레임률입니다. 25 또는 50 FPS를 선택할 수 있습니다.",
      "type": "integer",
      "enum": [
        25,
        50
      ],
      "default": 25
    },
    "generate_audio": {
      "title": "오디오 생성",
      "description": "영상과 함께 오디오를 생성할지 지정합니다. 기본값은 true입니다.",
      "type": "boolean",
      "default": true
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

텍스트로 16:9 동영상을 만들고 길이, 해상도, 프레임률, 오디오 생성 여부를 지정합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

텍스트로 16:9 동영상을 만들고 길이, 해상도, 프레임률, 오디오 생성 여부를 지정합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

LTX 2 Fast Text-to-Video: 오디오를 선택할 수 있는 16:9 영상 | RunComfy

텍스트로 16:9 동영상을 만들고 길이, 해상도, 프레임률, 오디오 생성 여부를 지정합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

LTX 2 Fast Text-to-Video: 오디오를 선택할 수 있는 16:9 영상 | RunComfy

텍스트로 16:9 동영상을 만들고 길이, 해상도, 프레임률, 오디오 생성 여부를 지정합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마