---
title: "LibreChat 사용자 지정 엔드포인트"
description: "관리자가 LibreChat 사용자 지정 엔드포인트를 구성하고, 사용자는 각자의 API 키를 직접 입력합니다."
headingIds: {"관리자 구성":"section-1","검증 및 문제 해결":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
LibreChat는 배포 관리자가 사용자 지정 엔드포인트를 허용해야 하며, 일반 사용자는 이 사이트의 버튼으로 원격 서버 구성을 덮어쓸 수 없습니다. 콘솔의 **API 키 → 도구 사용 → LibreChat**에서 구성 조각을 제공합니다.

## 관리자 구성

기존 `librechat.yaml`에 `endpoints.custom`을 병합하고, 다른 엔드포인트를 덮어쓰지 마세요:

```yaml
endpoints:
  custom:
    - name: '1折AI'
      apiKey: user_provided
      baseURL: 'https://1zheai.com/v1'
      models:
        default: []
        fetch: true
```

현재 버전에서 요구하는 구성 검증을 적용하고 서비스를 재시작한 다음, 사용자가 LibreChat의 API 키 설정에서 자신의 키를 입력하도록 하세요. 공유 구성에는 실제 키가 포함되지 않습니다. 모델 가져오기에 실패하면 관리자가 `default`을 검증된 사용 가능한 모델 ID로 설정하고 서버의 아웃바운드 연결을 확인할 수 있습니다.

## 검증 및 문제 해결

새 엔드포인트와 모델을 선택하여 짧은 요청을 보낸 다음, 이 사이트의 호출 로그를 확인하세요. 엔드포인트가 표시되지 않으면 구성 마운트 위치와 재시작이 적용되었는지 먼저 확인하세요. 401은 사용자가 입력한 키를 확인하세요. 404는 Base URL이 전체 요청 경로가 아닌 `/v1`인지 확인하세요. 신뢰할 수 없는 공개 LibreChat 인스턴스에 키를 보관하지 마세요.

공식: [사용자 지정 엔드포인트 필드](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint).

<Note> 프로토콜 및 공식 자료와 대조 확인일: 2026-10-19. 이 사이트는 구성 생성 및 프런트엔드 회귀 테스트를 구현했습니다. 모든 클라이언트, 시스템 및 모델에 대한 실제 추론 검증은 완료되지 않았습니다. 클라이언트 업그레이드 후 다시 검증하세요. 사용자 지정 연결은 공식 협업이나 내장 추천을 의미하지 않습니다. </Note>

더보기: [API 키](/ko/docs/api-keys/), [모델 목록](/ko/docs/models/), [호출 로그](/ko/docs/usage-logs/), [주소 설명](/ko/docs/base-url/).