UberLLM을 위한 LibreChat 사용자 지정 endpoint (librechat.yaml)
librechat.yaml에 UberLLM이라는 이름의 사용자 지정 endpoint를 추가하세요. baseURL https://api.uberllm.dev/v1 및 apiKey "${UBERLLM_API_KEY}"로 설정하고, key는 .env 파일에 넣은 다음 LibreChat을 다시 시작하세요. 전체 모델 목록을 가져오려면 models.fetch를 켜세요.
단계
- 여러분의 키 페이지에서 키를 만들고 크레딧을 추가하세요.
- LibreChat 폴더에 있는
.env파일에 키를 추가하세요:
UBERLLM_API_KEY=ull_your_key
이 이름을 사용하세요, OPENAI_API_KEY 대신, 내장된 OpenAI 엔드포인트가 이를 가져가지 않도록.
librechat.yaml에 UberLLM을 추가하세요 (.env과 같은 폴더에):
version: 1.3.18
cache: true
endpoints:
custom:
- name: "UberLLM"
apiKey: "${UBERLLM_API_KEY}"
baseURL: "https://api.uberllm.dev/v1"
models:
default: ["deepseek/deepseek-v4.1-flash", "google/gemini-3.5-flash", "anthropic/claude-sonnet-5.5"]
fetch: true
titleConvo: true
titleModel: "current_model"
modelDisplayLabel: "UberLLM"
만약 파일에 이미 endpoints: custom:이 있다면, 해당 목록에 - name: "UberLLM" 블록만 추가하세요. 파일의 version 줄이 더 최신이라면 그대로 유지하세요.
- Docker: 파일이 마운트되었는지 확인하세요.
docker-compose.override.yml에서:
services:
api:
volumes:
- type: bind
source: ./librechat.yaml
target: /app/librechat.yaml
- 재시작:
docker compose down && docker compose up -d(또는npm프로세스를 재시작하세요). - 엔드포인트 메뉴에서 UberLLM을 선택하고 모델을 선택하세요.
각 필드의 기능
- baseURL: LibreChat이 여기에
/chat/completions을 추가합니다. 그러니/v1에서 멈추세요. - models.default: 항상 표시되는 모델입니다. fetch: true는 UberLLM에 해당 모델들 외에 전체 목록을 요청합니다.
- titleModel: "current_model": 채팅 제목은 현재 대화 중인 모델이 작성합니다. 대신
deepseek/deepseek-v4.1-flash와 같은 저렴한 ID를 설정하여 제목 생성 비용을 거의 0으로 유지하세요. - 각 사용자가 자신만의 UberLLM key를 사용하게 하고 싶으신가요?
apiKey: "user_provided"을 설정하면 LibreChat이 사용자에게 요청합니다.
문제 해결
- UberLLM이 메뉴에 나타나지 않습니다: LibreChat이 파일을 읽지 못했습니다. 파일이
.env옆(또는CONFIG_PATH에)에 있는지, Docker에 마운트되었는지 확인하고, 구성 오류가 있는지docker compose logs api를 읽어보세요. 잘못된 파일은 LibreChat이 시작되는 것을 막습니다. - 401: 컨테이너 내부의
${UBERLLM_API_KEY}이 비어 있습니다..env줄을 확인하고 다시 시작하세요. - 404 모델을 찾을 수 없습니다: ID는 앞에 제조사 이름을 붙여야 합니다. 예를 들어
deepseek/deepseek-v4.1-flash와 같이요. - 402 크레딧 부족: 크레딧 페이지에서 크레딧을 추가하세요.
- 모델이 설정을 거부합니다: 이 엔드포인트에 대해
dropParams: ["stop"](또는["user"])을 사용하여 해당 설정을 제거하세요.