Skip to main content
앱의 오류 메시지는 현재 화면 언어로 표시됩니다. 이 페이지는 한국어 화면에 표시되는 문구를 인용합니다. 모델 제공업체가 반환한 원본 오류 메시지(예: HTTP 429: ...)는 번역되지 않습니다.

​
배포와 접속

서버에 유효한 DEEPSEEK_API_KEY 또는 GEMINI_API_KEY가 없고, 브라우저 설정에도 키를 입력하지 않았습니다.
  • Docker: .env.production을 수정한 뒤 docker compose up -d를 실행해 컨테이너를 다시 만드세요.
  • Vercel: Settings → Environment Variables에 변수를 추가한 뒤 다시 배포하세요.
  • 로컬 개발: .env.local을 수정한 뒤 npm run dev를 다시 시작하세요.
앱은 기본적으로 DeepSeek를 사용합니다. 설정을 열고 AI 제공업체를 Gemini로 바꾼 다음 설정 저장을 누르세요.
클라우드 보안 그룹이나 시스템 방화벽에서 해당 포트를 열지 않았습니다. 3002를 열거나, 리버스 프록시를 설정한 뒤 80과 443을 여세요.
도메인이 아직 서버를 가리키지 않거나 80 포트가 열려 있지 않습니다. A 레코드가 적용되었는지 확인한 뒤 다시 시도하세요.
프로덕션 환경에서는 세션 Cookie에 Secure 플래그가 붙어 HTTPS에서만 저장됩니다. 사이트에 HTTPS를 설정하세요. CODE를 바꾸면 기존 세션도 모두 무효가 됩니다.

​
분석과 번역

설정에서 스트리밍 출력을 끄고, 전체 결과를 한 번에 받도록 바꾸세요. Nginx 리버스 프록시를 사용한다면 proxy_buffering off를 설정했는지도 확인하세요.
모델이 반환한 단어를 이어 붙인 결과가 원문과 다릅니다. 다시 분석하거나 다른 모델 버전으로 바꾸세요.
출력이 모델의 길이 상한을 넘었습니다. 원문을 줄이거나 여러 번에 나누어 분석하세요.
모델 제공업체가 60초 안에 응답하지 않았습니다. 서버와 모델 제공업체 사이의 네트워크를 확인하고 잠시 후 다시 시도하세요.
스트리밍 출력에서 90초 넘게 새 내용을 받지 못했습니다. 다시 분석해 보세요. 자주 발생하면 설정에서 스트리밍 출력을 끄세요.
해당 단어들을 선택하세요. 앱이 한 단어라고 판단하면 한 단어로 합치기를 누르세요. 자세한 내용은 단어 상세 설명과 여러 단어 선택을 참고하세요.

​
기타 기능

서버에 사용 가능한 API 키가 없거나, 외부 네트워크에서 모델 제공업체에 접속할 수 없어 앱이 내장된 예비 문장 7개를 사용하고 있습니다. 오늘의 문장은 서버 키만 사용하며 브라우저에 입력한 키는 사용하지 않습니다.
Gemini TTS에는 Gemini API 키가 필요합니다. 서버에 GEMINI_API_KEY를 설정하거나 설정에서 Gemini 키를 입력하세요. 키가 필요 없는 Edge TTS로 되돌릴 수도 있습니다.
브라우저에서 로컬 저장소가 비활성화되어 있거나 시크릿 모드입니다. 일반 창을 사용하거나 사이트의 데이터 저장을 허용하세요.

​
문제 보고

위 내용으로 해결되지 않으면 GitHub에 Issue를 등록하세요. 분석 문제를 보고할 때는 다음을 함께 적어 주세요.
  • 모델 제공업체와 모델 버전
  • 화면 언어
  • 문제를 재현할 수 있는 원문
Issue에 API 키나 접속 비밀번호를 붙여넣지 마세요.