신청 절차
LobeChat에서 Ace Data Cloud에 연결하려면 먼저 Ace Data Cloud 콘솔로 이동하여 API Token을 가져와 예비용으로 보관하세요.
아직 로그인하거나 가입하지 않은 경우, 로그인 페이지로 자동 이동하여 가입 및 로그인을 안내하며, 로그인 및 가입 후 현재 페이지로 자동 반환됩니다.
최초 신청 시 무료 크레딧이 제공되므로 Ace Data Cloud의 모델 서비스를 무료로 체험할 수 있습니다.
Ace Data Cloud 구성
LobeChat의 애플리케이션 설정 → 언어 모델로 이동하여 OpenAI 카드를 찾아 활성화한 후, 다음을 입력하세요:
Chat Completions 인터페이스를 사용할 때는 Responses API Specification을 비활성화한 상태로 유지하세요.LobeChat은 Base URL에
/v1을 자동으로 추가하지 않으며, 요청 경로는 직접 {API 프록시 주소}/chat/completions입니다:
LobeChat은 기본적으로
/v1/models를 호출하여 모델을 자동으로 가져옵니다. Ace Data Cloud가 반환하는 모델이 많으면 화면이 매우 길어질 수 있으므로, 「모델 목록 → 사용자 지정 모델 이름」에서 영어 쉼표로 구분된 allow list를 수동으로 입력하는 것을 권장합니다. 사용자 지정 표시 이름이 필요한 경우 =를 사용할 수 있으며, 형식은 MODEL_ID=표시 이름입니다.
모델 선택
모델 카탈로그는 계속 업데이트됩니다. 클라이언트가 자동으로 로드한 모델 목록을 우선 사용하세요. 수동으로 입력해야 하는 경우 먼저GET https://api.acedata.cloud/v1/models를 요청하여 현재 모델 ID를 가져온 후, 클라이언트가 지원하는 컨텍스트, 이미지 및 도구 호출 기능에 따라 선택하세요.
연결 검증
문제가 LobeChat에 있는지 네트워크에 있는지 확실하지 않다면, 먼저 curl로 엔드포인트를 직접 검증할 수 있습니다（{token}을 당신의 Token으로 교체하세요）:
chat.completion 객체가 반환되면 Token과 엔드포인트가 모두 준비되었음을 의미합니다. HTTP 403 used_up이 반환되면 Token은 유효하지만 잔액이 부족한 것이므로 콘솔에서 충전하면 됩니다.
고급: Docker 자체 배포
팀에서 사용할 개인 버전을 배포하려면 Docker 한 줄 명령으로 시작할 수 있습니다（{token}을 당신의 Token으로 교체하세요）:
http://당신의 서버IP:3210을 열고 ACCESS_CODE를 입력하면 사용할 수 있으며, 팀 구성원은 각자 Key를 입력할 필요가 없습니다. 위에서 사용한 OPENAI_API_KEY, OPENAI_PROXY_URL, OPENAI_MODEL_LIST 등의 환경 변수에 대한 전체 설명은 LobeChat 모델 제공업체 환경 변수 문서를 참조하세요. nginx 리버스 프록시로 HTTPS를 추가하는 경우 반드시 proxy_buffering off;를 추가하세요. 그렇지 않으면 스트리밍 응답이 버퍼링됩니다. 더 많은 배포 형태는 LobeChat 자체 배포 시작하기 및 Docker Compose 배포를 참조하세요.
자주 묻는 질문
404 Not Found가 표시됨
일반적으로 API 프록시 주소를.../openai/v1로 작성했거나 /v1을 누락한 경우입니다. https://api.acedata.cloud/v1로 변경하세요.
모델 목록이 비어 있음
「클라이언트 요청 모드」 스위치를 켜거나, 「사용자 지정 모델 이름」에서 모델 allow list를 수동으로 입력하세요.401 Unauthorized가 표시됨
API Key에 Ace Data Cloud의 Token이 붙여넣어졌는지（Bearer 접두사 없이, 불필요한 공백 없이）와 해당 애플리케이션의 잔액이 충분한지 확인하세요.