동영상 생성
Elftia의 동영상 생성 기능은 텍스트 설명이나 참조 이미지로부터 AI를 사용하여 짧은 동영상을 생성하는 것을 지원합니다. 주요 동영상 생성 프로바이더를 여러 곳 통합하며, 시간이 걸리는 동영상 렌더링 프로세스를 처리하기 위해 비동기 폴링 모델을 사용합니다.
활용 사례
- 텍스트 설명으로 짧은 동영상 클립 생성
- 정적 이미지를 동적 동영상으로 변환 (이미지-동영상 변환)
- 소셜 미디어 또는 프레젠테이션용 창의적인 동영상 신속 생성
- 여러 프로바이더의 생성 결과 비교
지원 프로바이더
| 프로바이더 | 주요 특징 | API 유형 |
|---|---|---|
| Kling AI | 고품질 동영상 생성; 다양한 해상도 지원 | 비동기 API |
| OpenAI (Sora) | OpenAI의 동영상 생성 모델 | 비동기 API |
| Replicate | 오픈 소스 모델 호스팅 플랫폼, 폭넓은 모델 선택 | 비동기 API |
| VolcEngine | 볼케노엔진 동영상 생성 서비스 | 비동기 API |
| Wan | Wan 동영상 생성 | 비동기 API |
| 커스텀 (Unified) | 통합 인터페이스와 호환되는 서드파티 서비스 | 비동기 API |
프로바이더 구성
설정 단계
- 설정 > 미디어 프로바이더 > 동영상을 엽니다
- 프로바이더를 선택합니다
- API Key를 입력합니다 (일부 프로바이더는 Access Key 또는 기타 인증 정보도 필요)
- (선택 사항) API 엔드포인트를 커스터마이즈합니다
- 기본 모델을 선택합니다
- 저장하고 활성화합니다
프로바이더 구성 표
| 설정 | 설명 | 필수 여부 |
|---|---|---|
| API Key | 프로바이더의 API 키 | 예 |
| API 엔드포인트 | 커스텀 API 주소 | 아니오 (기본값: 공식 주소) |
| 기본 모델 | 사용할 기본 동영상 모델 | 아니오 |
| 활성화 | 이 프로바이더의 활성화 여부 | 예 |
동영상 생성하기
생성 단계
- 동영상 생성 기능을 선택합니다
- 프로바이더와 모델을 선택합니다
- 동영상 내용을 설명하는 텍스트 프롬프트를 입력합니다
- (선택 사항) 참조 이미지를 업로드합니다 (이미지-동영상 변환 모드)
- 생성 파라미터를 구성합니다
- 생성을 클릭합니다
- 비동기 작업이 완료될 때까지 기다립니다
생성 파라미터
파라미터는 프로바이더마다 다르며, 주요 파라미터는 다음과 같습니다:
| 파라미터 | 설명 | 비고 |
|---|---|---|
| 프롬프트 | 동영상 내용에 대한 텍스트 설명 | 필수 |
| 참조 이미지 | 동영상의 시작 프레임으로 사용할 이미지 | 선택 사항; 이미지-동영상 변환 모드 |
| 길이 | 동영상 길이 (초 단위) | 프로바이더에 따라 다름 |
| 해상도 | 동영상 해상도 | 예: 720p, 1080p |
| FPS | 초당 프레임 수 | 프로바이더에 따라 다름 |
비동기 폴링 모델
동영상 생성은 일반적으로 상당한 시간이 소요되므로 (수십 초에서 수 분), Elftia는 비동기 폴링 메커니즘을 사용합니다:
생성 요청 제출 → 작업 ID 수신 → 주기적으로 상태 폴링 → 작업 완료 → 동영상 다운로드
동작 방식
- 요청 제출 — 프로바이더 API에 생성 요청을 보내고 작업 ID를 수신합니다
- 상태 폴링 — 시스템이 정기적으로 작업 상태를 자동 조회합니다 (일반적으로 5~10초 간격)
- 작업 완료 — 상태가 완료로 변경되면 생성된 동영상 파일을 자동 다운로드합니다
- 결과 표시 — 동영상이 UI에 표시되고 재생할 수 있습니다
대기 중에는 현재 작업 상태와 남은 예상 시간이 UI에 표시됩니다 (프로바이더가 지원하는 경우).
자동 재시도
생성 중 임시 오류가 발생하면 시스템이 자동으로 재시도합니다:
| 설정 | 설명 | 기본값 |
|---|---|---|
| 재시도 횟수 | 실패 후 최대 재시도 횟수 | 2 |
| 재시도 간격 | 지수 백오프 사용 | 1초부터 시작 |
전역 동영상 설정
| 설정 | 설명 | 기본값 |
|---|---|---|
| 동시성 | 동시 동영상 생성 작업 수 | 1 |
| 재시도 횟수 | 생성 실패 시 자동 재시도 횟수 | 2 |
이 파라미터들은 설정 > 미디어 프로바이더 > 동영상 > 전역 설정에서 조정할 수 있습니다.
프로바이더 선택 가이드
| 요구 사항 | 추천 프로바이더 |
|---|---|
| 고품질 상업용 동영상 | Kling AI |
| OpenAI 생태계 통합 | OpenAI (Sora) |
| 유연한 오픈 소스 모델 선택 | Replicate |
| 안정적인 중국 내 접속 | VolcEngine |
자주 묻는 질문
| 질문 | 해결 방법 |
|---|---|
| 작업이 계속 "대기 중" 상태에 있음 | 동영상 생성에는 시간이 걸립니다 — 기다려 주세요. 고품질 모델은 수 분이 걸릴 수 있습니다 |
| 타임아웃 오류로 생성 실패 | 프로바이더에 부하가 높을 수 있습니다 — 나중에 다시 시도하세요 |
| 동영상이 재생되지 않음 | 동영상 형식이 시스템에서 지원되는지 확인하세요; 외부 플레이어를 사용해 보세요 |
| API 키 확인 실패 | API 키가 올바른지, 계정에 충분한 할당량이 있는지 확인하세요 |
| 커스텀 프로바이더가 호환되지 않음 | API 인터페이스가 통합 인터페이스 사양 (Unified 형식)을 따르는지 확인하세요 |