Skip to main content
LobeHub는 여러 모델, 멀티모달 입력, 플러그인 마켓플레이스, 로컬 지식 기반을 지원하는 오픈소스 크로스플랫폼 AI 채팅 클라이언트(이전 명칭은 Lobe Chat)입니다. APIYI를 사용하면 LobeHub에서 단일 API 키로 400개 이상의 주류 AI 모델에 접근할 수 있으며, 각 제공자에 따로 가입하고 결제할 필요가 없습니다.

오픈소스 및 자체 호스팅 가능

데스크톱, 웹, Docker 또는 Vercel — 데이터는 당신의 것이고, 통제권은 당신에게 있습니다

플러그인 및 멀티모달

내장 웹 검색, 코드 인터프리터, 비전, 동영상 생성 플러그인

로컬 지식 기반

PDF와 Markdown을 업로드하여 비공개 데이터를 바탕으로 RAG 파이프라인을 구축합니다

빠른 시작

1. APIYI API 키 받기

API 키를 받으려면 API 키 관리 가이드를 참조하십시오.

2. LobeHub 설치

로브허브는 다음 세 가지 사용 방법을 제공합니다.
  • 데스크톱: Windows, macOS, Linux용 공식 클라이언트 — lobechat.com에서 다운로드
  • 웹(공식): lobechat.com에 접속해 가입하면 별도의 자체 호스팅 없이 사용할 수 있습니다
  • 자체 호스팅: Docker / Vercel / 로컬 소스 코드로 배포 — 엔터프라이즈 또는 개인정보 보호 요구에 적합합니다
개인 용도라면 공식 웹 또는 데스크톱 클라이언트를 권장합니다. 데이터 개인정보 보호나 규정 준수 요구사항이 있다면 Docker로 자체 호스팅하십시오(APIYI는 환경 변수를 통해 구성하기만 하면 됩니다).

3. 맞춤형 제공자 만들기

로브허브 — 맞춤형 AI 서비스 제공자 만들기 Settings → Model Providers로 이동한 다음, 오른쪽 상단의 + 아이콘을 클릭하여 맞춤형 제공자를 추가하고, 위에 표시된 대로 필드를 입력하십시오. 오른쪽 아래의 생성 버튼을 클릭하여 저장하십시오.
설정 팁
  • Proxy URL는 반드시 /v1로 끝나야 하며, 그렇지 않으면 요청이 라우팅되지 않습니다
  • API 키를 붙여넣을 때 앞뒤 공백을 제거하십시오
  • 모든 400개 이상의 APIYI 모델에 접근하려면 요청 형식으로 OpenAI을 선택하십시오
  • 하나의 키로 활성화된 모든 모델에서 사용할 수 있으며 — 사용한 만큼만 과금됩니다

4. 연결 확인

로브허브 — 구성된 제공자 화면 제공자를 생성하면 해당 상세 페이지로 이동합니다. 여기에서 다음 작업을 할 수 있습니다.
  1. API 키와 프록시 URL 확인 또는 업데이트
  2. 고급 옵션 사용(선택 사항):
    • Use Responses API spec — OpenAI의 최신 요청 형식을 사용합니다(OpenAI 모델에만 해당)
    • Use client-side request mode — 브라우저가 요청을 직접 보내므로 응답 속도를 향상시킬 수 있습니다
  3. 연결 확인 — 드롭다운에서 모델을 선택하고 확인을 클릭합니다
  4. 모델 목록 가져오기모델 목록 가져오기 버튼을 클릭하여 APIYI의 사용 가능한 모든 모델을 가져옵니다
가져오기에 성공하면 Model list에 APIYI가 현재 제공하는 모든 항목이 유형별로 채팅, 이미지, 동영상, 임베딩, ASR, TTS로 그룹화되어 표시됩니다.
연결 확인에 실패하면 다음 체크리스트를 따라 점검하십시오.
  • 프록시 URL이 /v1로 끝납니까?
  • API 키가 아직 유효합니까? (APIYI 콘솔에서 확인하십시오)
  • 네트워크에서 api.apiyi.com에 도달할 수 있습니까?
  • 방화벽이나 프록시가 HTTPS 트래픽을 차단하고 있습니까?

5. 모델을 선택하고 채팅 시작

채팅 UI의 모델 드롭다운에서 deepseek-v4-pro, claude-sonnet-4-5 또는 gpt-5 같은 모델을 선택하면 바로 사용할 수 있습니다.

오늘의 상위 모델 추천 보기

최신 모델 추천, 성능 비교, 시나리오별 활용 팁을 살펴보십시오. 글쓰기, 코딩, 빠른 응답, 이미지 생성, 동영상 생성 등을 모두 다룹니다.
여기에 구체적인 모델 목록이 없는 이유는 무엇입니까?AI 모델은 매우 빠르게 반복 개선됩니다. 추천의 정확도를 유지하기 위해 모델 추천 페이지에 최신 모델 목록, 성능 데이터, 사용 팁을 계속 반영하고 있습니다.

하나의 공급자로 400개 이상의 모든 모델에 접근하기

LobeHub에는 여러 주요 공급자를 위한 내장 채널이 포함되어 있습니다. 사용 사례에 맞는 채널을 선택하십시오:
하나의 apiyi 채널로 Claude, Gemini, 그리고 다른 모든 모델을 모두 지원합니다APIYI는 Claude, Gemini, GPT, DeepSeek 및 기타 최상위 모델을 OpenAI 호환 프로토콜 아래에 묶습니다. 따라서 LobeHub에서 하나의 apiyi 사용자 지정 공급자만 설정하면 드롭다운의 400개 이상의 모든 모델에 접근할 수 있습니다 — 공급자별로 별도 채널을 설정할 필요가 없습니다.

LobeHub 기능 심층 분석

플러그인 마켓플레이스

LobeHub에는 풍부한 플러그인 마켓플레이스(Settings → Plugins)가 포함되어 있습니다. 추천 플러그인은 다음과 같습니다.
  • Web Search — 모델에 실시간 인터넷 접근을 제공합니다
  • Code Interpreter — 채팅 안에서 Python을 실행하여 데이터 분석과 시각화를 수행합니다
  • Chart Generation — 플로차트와 마인드맵을 자동 생성합니다
  • Image Generationgpt-image-1, flux-kontext-pro 같은 모델을 통해 이미지를 생성합니다

로컬 지식 베이스 (RAG)

LobeHub는 파일로부터 로컬 벡터 스토어를 구축할 수 있습니다.
  1. Knowledge Base 페이지로 이동하여 새 지식 베이스를 만듭니다
  2. PDF, Markdown, Word, Excel, 또는 TXT 파일을 업로드합니다
  3. 시스템이 자동으로 청크로 나누고 임베딩합니다
  4. 채팅에서 지식 베이스를 선택하면 모델이 파일을 근거로 답변합니다
임베딩 단계에서는 임베딩 모델을 호출하며, 이 모델은 과금됩니다. APIYI의 text-embedding-3-large 또는 유사한 임베딩 모델을 사용하는 것을 권장합니다.

멀티모달 채팅

비전 이해, 인식, OCR을 위해 이미지를 업로드합니다.
  • 추천 비전 모델: gpt-4o, claude-sonnet-4-5, gemini-3-pro-image-preview
  • 이미지를 채팅 입력창에 끌어다 놓기만 하면 모델이 이를 인식합니다

에이전트 마켓플레이스

LobeHub에는 다양한 프리셋 에이전트(번역, 글쓰기, 코딩, 면접 준비 등)가 포함되어 있습니다. 또한 다음도 가능합니다.
  • Agent marketplace에서 커뮤니티가 공유한 에이전트를 원클릭으로 활성화합니다
  • 자체 에이전트를 구축합니다 — 사용자 지정 페르소나, prompt, 시작 문구, 지식 베이스, 그리고 플러그인

대화 관리

  • 대화를 분기하고, 메시지를 편집하고, 응답을 다시 생성합니다
  • 대화를 Markdown, PNG, 또는 JSON으로 내보냅니다
  • 메시지 기록 전체에서 전역 검색합니다

고급 설정

사용자 지정 요청 파라미터

공급자 상세 페이지에서 공통 파라미터를 조정할 수 있습니다:
추론 모델(GPT-5, DeepSeek-R1, o1 시리즈 등)은 Temperature = 1Top P = 1만 지원합니다. 다른 값은 무시되거나 서버 측에서 오류를 일으킬 수 있습니다.

네트워크 프록시 및 자체 호스팅

프록시 사용 또는 자체 호스팅 LobeHub의 경우:
  1. 데스크톱 클라이언트: Settings → Network로 HTTP/HTTPS 프록시를 구성합니다
  2. 자체 호스팅(Docker): 환경 변수를 통해 APIYI 설정을 주입합니다:
  3. 클라이언트 측 요청 모드: 브라우저 직접 요청을 활성화합니다(브라우저가 APIYI에 연결할 수 있는 경우에만)

키보드 단축키

모바일

LobeHub의 데스크톱 클라이언트는 Windows / macOS / Linux에서 실행됩니다. 모바일에서는 lobechat.com의 반응형 웹 앱을 사용하십시오. 별도 설치가 필요하지 않습니다.

문제 해결

연결 실패 / 연결 확인 실패

모델 목록이 비어 있음

  • 모델 목록 가져오기를 클릭하여 다시 가져옵니다
  • 1~2초 기다린 뒤 페이지를 새로 고칩니다
  • APIYI 콘솔에서 API key가 활성 상태인지 확인합니다

응답이 느리거나 스트리밍이 중단됨

  • 더 빠른 모델로 전환합니다(예: gpt-5-mini, claude-haiku-4-5, deepseek-v4-flash)
  • 불필요한 플러그인을 비활성화합니다
  • 네트워크 지연 시간을 확인합니다
  • 긴 컨텍스트를 줄입니다(오래된 대화를 닫습니다)

지식 베이스 검색이 부정확함

  • 더 세밀한 검색을 위해 chunk 크기를 줄입니다
  • APIYI에서 더 강력한 embedding 모델로 전환합니다
  • 더 관련성 높은 문서를 추가하여 재현율을 높입니다

모범 사례

모델 선택 전략

작업에 맞는 적절한 모델을 사용하십시오 — 복잡도에 맞춰 선택하십시오:
  • 일상 채팅 / 간단한 Q&A: gpt-5-mini, claude-haiku-4-5, deepseek-v4-flash
  • 복잡한 추론 / 장문 문서 분석: gpt-5, claude-opus-4-5, deepseek-v4-pro
  • 코딩: claude-sonnet-4-5, gpt-5, deepseek-v4-pro
  • 이미지 이해: gpt-4o, claude-sonnet-4-5, gemini-3-pro-image-preview
  • 이미지 생성: gpt-image-1, flux-kontext-pro
전체 모델 목록과 성능 비교는 모델 추천 페이지를 참고하십시오.

컨텍스트 관리

  • 오래된 대화는 주기적으로 정리하십시오
  • 복잡한 작업은 더 짧은 대화로 나누십시오
  • branch conversation 기능을 사용해 대안 답변을 탐색하십시오

보안 및 개인정보 보호

  • API 키를 공개적으로 공유하지 마십시오
  • 키는 주기적으로 교체하십시오(APIYI 콘솔에서 원클릭 재설정 가능)
  • 민감한 대화에는 LobeHub를 자체 호스팅하십시오 — 데이터는 로컬에 유지됩니다

자체 호스팅 팁

  • 운영 환경에서는 내장 DB가 아니라 Docker + PostgreSQL을 사용하십시오
  • Cloudflare를 리버스 프록시로 앞단에 배치하십시오
  • 여러 인스턴스에 쉽게 배포할 수 있도록 환경 변수를 통해 비밀값을 관리하십시오

다른 클라이언트와의 비교

언제 LobeHub를 선택해야 합니까?
  • 로컬 지식 베이스 또는 플러그인 생태계(웹 검색, 코드 인터프리터, 차트 등)가 필요합니다.
  • 완전한 데이터 제어가 가능한 개인 배포를 원합니다.
  • 데스크톱 + 웹 전반에서 하나의 통합된 오픈소스 UI를 원합니다.
기본 제공 경험네이티브 모바일 앱을 우선한다면 ChatBox를 선택하십시오. Prompt Cache 절감 효과가 있는 Claude / Gemini 네이티브 프로토콜을 우선한다면 Cherry Studio를 선택하십시오.
더 도움이 필요하십니까? lobechat.com 문서를 확인하거나 APIYI 웹사이트를 방문하십시오.