docs/kr/faq.md
이는 일반적인 설정 문제입니다. 다음과 같은 몇 가지 이유가 있을 수 있습니다:
config.toml이라는 이름의 구성 파일이 필요합니다. 실수로 config.toml.txt로 이름을 바꾸지 않았는지 확인하세요.config 폴더 안에 위치해야 합니다. 작업 디렉토리의 올바른 구조는 다음과 같아야 합니다:
/── config/
│ └── config.toml
└── krillinai.exe(실행 파일)
config.toml 파일의 서로 다른 섹션에 키를 입력해야 합니다. llm 섹션, transcribe 섹션, tts 섹션을 찾아 해당 API 키 및 기타 필요한 정보를 입력하세요.이 오류는 비디오 다운로드 프로그램에 문제가 있음을 나타내며, 일반적으로 네트워크 또는 다운로드 프로그램의 버전과 관련이 있습니다.
네트워크: 프록시를 사용하는 경우, config.toml 파일 내의 프록시 설정에서 올바르게 구성되었는지 확인하세요.
yt-dlp 업데이트: 소프트웨어에 포함된 yt-dlp 버전이 구식일 수 있습니다. 소프트웨어의 bin 디렉토리에서 터미널을 열고 다음 명령을 실행하여 수동으로 업데이트할 수 있습니다:
./yt-dlp.exe -U
(운영 체제에 따라 파일 이름이 다를 경우 yt-dlp.exe를 올바른 파일 이름으로 교체하세요).
이는 거의 항상 시스템에 필요한 글꼴이 누락되어 발생하며, 특히 중국어 문자를 지원하는 글꼴이 필요합니다. 이를 해결하려면 필요한 글꼴을 설치해야 합니다.
sudo mkdir -p /usr/share/fonts/msyh..ttc 글꼴 파일을 이 새 디렉토리에 복사합니다.cd /usr/share/fonts/msyh
sudo mkfontscale
sudo mkfontdir
sudo fc-cache -fv
이는 macOS의 보안 기능인 Gatekeeper로 인해 발생하며, 이는 확인되지 않은 개발자의 앱을 제한합니다. 이를 해결하려면 수동으로 격리 속성을 제거해야 합니다.
xattr -cr 명령을 입력한 후 공백을 추가하고, Finder 창에서 KrillinAI.app 파일을 터미널로 드래그합니다. 명령은 다음과 비슷하게 보일 것입니다:
xattr -cr /Applications/KrillinAI.app
ffmpeg 오류, audioToSrt 오류 또는 exit status 1과 같은 오류가 발생합니다.이러한 오류는 일반적으로 종속성 또는 시스템 리소스 문제를 나타냅니다.
ffmpeg 오류: 이는 ffmpeg가 설치되지 않았거나 시스템의 PATH에서 접근할 수 없음을 나타냅니다. 공식 버전의 ffmpeg가 완전하게 설치되어 있고, 그 위치가 시스템 환경 변수에 추가되어 있는지 확인하세요.audioToSrt 오류 또는 exit status 1: 이 오류는 전사 단계(오디오-텍스트)에서 발생합니다. 일반적인 원인은 다음과 같습니다:
fasterwhisper)이 로드되지 않거나 다운로드 중 손상되었습니다.아니요, 오류 메시지가 표시되지 않는 한 프로그램은 작동 중입니다. 진행 표시줄은 주요 작업(예: 전사 또는 비디오 인코딩)이 완전히 완료된 후에만 업데이트됩니다. 이러한 작업은 매우 시간이 많이 소요될 수 있으며, 진행 표시줄이 오랜 시간 동안 멈춘 것처럼 보일 수 있습니다. 인내심을 가지고 작업이 완료될 때까지 기다려 주세요.
fasterwhisper에서 지원되지 않습니다. 어떻게 해야 하나요?fasterwhisper 모델이 NVIDIA 5000 시리즈 GPU에서 제대로 작동하지 않을 수 있습니다(2025년 중반 기준). 전사에 대한 몇 가지 대안이 있습니다:
config.toml 파일에서 transcribe.provider.name을 openai 또는 aliyun으로 설정합니다. 그런 다음 해당 API 키 및 구성 세부정보를 입력합니다. 이렇게 하면 로컬 모델 대신 클라우드 제공자의 Whisper 모델을 사용하게 됩니다.whisper.cpp와 같은 다른 로컬 전사 모델을 실험해 볼 수 있습니다.사용 중인 음성 서비스 제공자가 정의한 사용 가능한 음성과 해당 코드가 있습니다. 공식 문서를 참조하세요.
예, KrillinAI를 OpenAI 호환 API 엔드포인트를 제공하는 로컬 LLM을 사용하도록 구성할 수 있습니다.
config.toml 편집: 대형 언어 모델(번역기) 섹션에서:name(또는 type)을 "openai"로 설정합니다.api_key를 임의의 문자열(예: "ollama")로 설정합니다. 로컬 호출에는 필요하지 않습니다.base_url을 로컬 모델의 API 엔드포인트로 설정합니다. Ollama의 경우 일반적으로 http://localhost:11434/v1입니다.model을 제공하는 모델의 이름으로 설정합니다. 예를 들어, "llama3"입니다.아니요. 현재 KrillinAI는 하드코딩된 자막을 생성하므로 자막이 비디오 프레임에 직접 삽입됩니다. 애플리케이션은 자막 스타일을 사용자 정의할 수 있는 옵션을 제공하지 않으며, 미리 설정된 스타일을 사용합니다.
고급 사용자 정의를 위해 권장되는 우회 방법은:
.srt 자막 파일을 생성합니다..srt 파일을 전문 비디오 편집기(예: Premiere Pro, Final Cut Pro, DaVinci Resolve)에 가져와서 렌더링 전에 사용자 정의 스타일을 적용합니다..srt 파일이 있습니다. KrillinAI가 이를 사용하여 더빙만 수행할 수 있나요?아니요, 현재 이 기능은 지원되지 않습니다. 애플리케이션은 전사에서 최종 비디오 생성까지 전체 파이프라인을 실행합니다.