NezhaGateNezhaGate

LobeHub는 사용자 지정 AI 공급자를 추가할 수 있습니다. 요청 형식을 OpenAI로 선택하고 주소를 /v1까지 입력하면 NezhaGate의 모든 모델을 쓸 수 있으며, 자체 호스팅 인스턴스는 환경 변수로도 설정할 수 있습니다.

작성 기준 버전: LobeHub 2.2

사용자 지정 공급자 추가하기

  1. App Settings → AI Providers를 열고 Add Custom Provider를 클릭하세요.
  2. 소문자로 Provider ID를 입력하고(소문자, 숫자, -, _만 가능하며 나중에 바꿀 수 없습니다), Request Format에서 OpenAI를 선택하고, Proxy URL에 https://nezhagate.com/v1을, API Key에 자신의 키를 입력한 뒤 Create를 클릭하세요.
  3. 공급자 페이지에서 Fetch models를 클릭하거나 Add Model로 직접 모델을 추가하세요. 이때 최대 컨텍스트 창을 설정하고, 모델이 지원하면 도구 호출과 비전에 체크하세요.
  4. 원하는 모델을 활성화한 뒤 채팅에서 선택하세요.
Proxy URLhttps://nezhagate.com/v1

Use Client Request Mode는 꺼 두세요(NezhaGate의 API는 브라우저의 크로스 오리진 요청을 받지 않습니다). Use Responses API Specification도 꺼 두세요.

Claude(선택 사항)

Request Format을 Anthropic으로, Proxy URL을 https://nezhagate.com/anthropic로 설정해 사용자 지정 공급자를 하나 더 추가하세요.

자체 호스팅: 환경 변수

자체 호스팅 LobeHub는 환경 변수만으로 NezhaGate를 가리키게 할 수 있습니다:

.env
OPENAI_API_KEY=YOUR_API_KEY
OPENAI_PROXY_URL=https://nezhagate.com/v1
OPENAI_MODEL_LIST=-all,+gpt-5.5,+claude-sonnet-5
ANTHROPIC_API_KEY=YOUR_API_KEY
ANTHROPIC_PROXY_URL=https://nezhagate.com/anthropic

OPENAI_MODEL_LIST에서 -all은 내장 모델을 모두 숨기고, +model-id는 NezhaGate의 모델을 추가하며, +model-id=Display name은 표시 이름도 함께 지정합니다.

테스트

공급자 페이지의 Connectivity Check에서 모델을 고르고 Check를 클릭하세요(짧은 메시지 하나를 보냅니다). Check passed가 뜨면 완료입니다.

자주 나오는 오류

응답이 없거나 빈 응답이 올 때

Proxy URL에는 반드시 /v1이 포함되어야 합니다: https://nezhagate.com/v1.

Failed to fetch models

키와 Proxy URL을 확인하세요. Add Model로 모델을 직접 추가할 수도 있습니다.

브라우저 콘솔에 CORS 오류가 뜰 때

Use Client Request Mode를 꺼서 요청이 LobeHub의 서버에서 나가도록 하세요.

다른 연동