LobeChat을 커스텀 OpenAI 호환 엔드포인트에서 실행하기.

빠른 답: 커스텀 프로바이더 하나, 엔드포인트 하나, 키 하나.

LobeChat 설정을 열고 AI 서비스 프로바이더 섹션(버전에 따라 AI Service Provider 또는 Language Model이라는 이름)으로 이동하세요. 프로바이더 관리 모듈이 v1.44에 도입된 이후로는, 내장 OpenAI 항목에 얹혀 가는 대신 커스텀 프로바이더를 만들 수 있습니다: 프로바이더를 추가하고, id와 표시 이름(apisrouter / APIsRouter)을 지정하고, SDK 유형으로 OpenAI를 선택한 다음, API 키와 엔드포인트 프록시 URL을 https://api.apisrouter.com/v1로 채우세요. 프로바이더의 모델 목록에서 fetch-models 작업으로 엔드포인트가 /v1/models를 통해 제공하는 모든 id를 가져온 다음, 원하는 것을 활성화하고 내장된 연결 확인을 실행하세요. 그 이후로는 어떤 어시스턴트나 대화에서든 모델 피커에서 그 id들을 선택할 수 있습니다. 프로젝트는 이제 GitHub의 lobehub/lobehub에 있으며(lobe-chat 저장소 이름은 그곳으로 리디렉션됩니다), 메뉴 레이블은 버전마다 바뀌므로, 정확한 문구가 아니라 흐름 — 프로바이더 항목, SDK 유형, URL, 키, fetch — 을 안정적인 부분으로 취급하세요.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → enable ids → check

LobeChat이 프로바이더로 요청을 라우팅하는 방법.

LobeChat(GitHub 스타 약 8만 개, 현재는 LobeHub라는 이름 아래에 있음)은 가장 많이 배포된 오픈소스 채팅 프레임워크 중 하나입니다: 정교한 웹 클라이언트, 자체 프롬프트와 모델을 가진 어시스턴트, 플러그인 시스템, 지식 베이스 기능을 갖추고 있으며, 브라우저 세션으로 배포하거나 데이터베이스와 함께 셀프 호스팅할 수 있습니다. 각 프로바이더 항목은 요청이 어디로 가는지, 어떤 SDK 방언으로 말할지를 기술합니다. OpenAI SDK 유형의 커스텀 프로바이더는 모델 id를 그대로 문자열로 담아 표준 chat-completions 요청을 여러분의 프록시 URL로 보내는데, 이는 정확히 멀티 벤더 게이트웨이가 기대하는 형태입니다. 그래서 항목 하나가 전체 카탈로그를 담을 수 있습니다: 어시스턴트는 신중한 작업에는 claude-sonnet-4-6을 고정해 두고 빠른 대화는 gemini-3.5-flash로 실행할 수 있으며, 어디에도 두 번째 계정이 필요 없습니다. 엔드포인트 URL에는 인용할 만한 문서화된 뉘앙스가 하나 있습니다: URL에 /v1 접미사가 필요한지는 그 뒤에 있는 서비스에 따라 다릅니다. LobeChat은 여러분이 준 베이스에 /chat/completions 같은 경로를 덧붙이므로, APIsRouter의 경우 올바른 값은 https://api.apisrouter.com/v1입니다. 접미사가 빠졌을 때 문서화된 증상은 테스트에서 모델이 빈 답을 반환하는 것입니다. 그런 경우를 보면 /v1을 추가하고 다시 시도하세요.

셀프 호스팅: 환경 변수 경로.

LobeChat을 직접 배포한다면, 같은 라우팅을 UI에서 클릭하는 대신 컨테이너에 함께 담아 보낼 수 있습니다. 고전적인 조합은 내장 OpenAI 프로바이더를 오버라이드합니다: OPENAI_API_KEY가 게이트웨이 키를 받고 OPENAI_PROXY_URL이 https://api.apisrouter.com/v1을 받습니다. 그러면 그 배포의 모든 사용자가 설정을 건드리지 않고도 그 엔드포인트를 상속받습니다. 모델 노출 여부는 모델 목록 문법으로 제어됩니다: OPENAI_MODEL_LIST는 추가하려면 +id, 숨기려면 -id, 이름을 바꾸려면 id=Display Name을 받아들이며, 항목은 쉼표로 구분합니다. 값을 -all로 시작하면 내장 목록이 지워지고 명시한 id만 표시되는데, 이는 엄선된 배포를 위한 깔끔한 형태입니다. 더 최신 서버 빌드는 UI 모듈이 하는 일과 맞먹는, 배포 시점에 완전한 커스텀 프로바이더를 선언하기 위한 CUSTOM_PROVIDER_* 계열(개수, id, 이름, 유형, 베이스 URL, 키)도 문서화하고 있습니다. 이는 OPENAI_* 조합보다 더 최신이며 여전히 변화하고 있으므로, 의존하기 전에 여러분 버전의 최신 환경 변수 레퍼런스를 확인하세요.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

어시스턴트를 위한 모델 선택.

모든 어시스턴트가 키 하나로 청구되므로, 모델 비교는 어시스턴트 설정 변경일 뿐입니다. 복제한 두 어시스턴트에 두 후보를 각각 고정해 두고, 일주일간 실제 프롬프트를 돌려본 다음, 관찰한 답변 품질과 함께 APIsRouter 콘솔의 모델별 지출을 확인하세요.

• 어시스턴트는 역할별로 모델을 고정합니다. 글쓰기 어시스턴트는 claude-sonnet-4-6, 빠른 답변 어시스턴트는 claude-haiku-4-5-20251001, 리서치 어시스턴트는 gpt-5.5로 — 모두 프로바이더 항목 하나 뒤에서 공존합니다.
• gemini-3.5-flash는 기본 대화 모델로 응답성이 좋은 선택입니다. 채팅 프레임워크에서 대부분의 턴은 짧으며, 빠른 모델은 UI를 즉각적으로 느껴지게 유지합니다.
• deepseek-v4-pro는 긴 다국어 대화와 방대한 요약 작업에서 제 자리를 차지합니다. 소모한 토큰당 긴 컨텍스트 처리 능력이 매력입니다.
• 비전 대화에는 비전을 지원하는 id가 필요하며, 프로바이더의 모델 설정에서 해당 기능을 활성화해야 합니다. LobeChat은 프로바이더 모듈에서 모델별 기능 토글을 노출합니다.
• 빠른 id 하나와 프론티어 id 하나로 이루어진 2단계 피커를 의도적으로 구성하고, 실제 어시스턴트가 필요로 할 때만 더 추가하세요. 활성화된 모델 하나하나가 사용자가 스크롤해야 할 행이 됩니다.

사용한 만큼 지불 · 공식 요금보다 저렴

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

LobeChat 특유의 실패 패턴.

연결 확인에서 빈 답이 오는 것은 베이스 URL 접미사 문제의 문서화된 특징입니다. 더 깊이 디버깅하기 전에 /v1을 추가하거나 제거해 보고(APIsRouter의 경우 반드시 있어야 합니다) 다시 시도하세요. 어시스턴트의 피커에 모델이 없다면 대개 가져오기는 했지만 프로바이더의 모델 목록에서 활성화하지 않았거나, 프로바이더 토글 자체가 꺼져 있는 것입니다. 둘 다 fetch 작업과 같은 설정 화면에 있습니다. 셀프 호스팅 배포에서는 우선순위를 기억하세요: 환경 변수는 서버 측 기본값을 설정하지만, 배포의 인증과 기능 플래그에 따라 사용자가 클라이언트 측에서 자신의 프로바이더 설정을 입력할 수도 있습니다. 배포가 OPENAI_PROXY_URL을 무시한다면, 컨테이너가 실제로 새 환경으로 재시작됐는지, 그리고 클라이언트 세션이 로컬에서 그것을 오버라이드하고 있지 않은지 확인하세요. 여기서 버전 변화는 실제로 존재합니다: 설정 트리는 한 번 이상 재구성되었으며(Language Model에서 AI Service Provider로, 프로바이더 모듈은 v1.44에 도입), 오래된 튜토리얼의 스크린샷은 현재 메뉴와 맞지 않을 것입니다. id, 이름, SDK 유형, URL, 키 같은 필드 자체는 안정적으로 유지되어 왔습니다.

어떤 사람들이 게이트웨이를 통해 LobeChat을 쓰는가.

• 팀을 위해 LobeChat을 셀프 호스팅하며, 사용자별 벤더 키 대신 컨테이너에 엔드포인트 하나와 모두를 위한 사용량 로그 하나를 두고 싶은 셀프 호스터.
• 역할마다 다른 벤더를 고정하는 어시스턴트 파워 유저 — 글쓰기는 Claude, 분석은 GPT, 물량은 DeepSeek — 각각에 계정을 유지하지 않고도.
• 내장 프로바이더 목록에는 없는 모델을 원하는 사용자 — 업스트림 릴리스를 기다리는 대신 게이트웨이 카탈로그를 가져와 활성화합니다.
• 특정 벤더의 결제 수단에 접근할 수 없는 개발자. 카드 없이 충전만으로 접근할 수 있어 프로바이더별 가입 의존성이 사라집니다.
• 이미 에디터, 런처, CLI 도구를 게이트웨이로 라우팅하고 있으며 채팅 프레임워크도 같은 키로 관리하고 싶은 사람들.

엔드포인트 검증 및 첫 대화 디버깅.

먼저 모델 목록을 curl로 확인하고 그 출력을 열어 두세요. fetch로든 손으로든 활성화할 모든 id의 정답 표기이기 때문입니다. 그다음 기본값으로 삼을 id에 대해 chat completion 하나를 실행해 보세요. LobeChat 안에서는 실제 대화 전에 연결 확인부터 하세요. 인증 실패는 키 필드를 가리킵니다. 빈 답은 /v1 접미사를 가리킵니다. 특정 모델에서의 not-found 오류는 활성화한 id가 목록과 일치하지 않는다는 뜻이며, 대개 표시 이름과 id를 함께 손으로 수정한 뒤에 발생합니다. 대화가 순조롭게 흐르면, APIsRouter 콘솔이 요청별 모델, 토큰 수, 지출을 보여줍니다. 어시스턴트를 갖춘 채팅 프레임워크는 여러 모델에 걸쳐 동시에 트래픽을 생성하며, 키별 사용량 뷰는 각 어시스턴트의 습관이 모델별·일별로 확인할 수 있는 비용으로 드러나는 곳입니다.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

자주 묻는 질문