신청 절차
Open WebUI에서 Ace Data Cloud에 연동하려면 먼저 Ace Data Cloud 콘솔로 이동하여 API Token을 받아 예비용으로 보관합니다.
아직 로그인하거나 등록하지 않았다면 로그인 페이지로 자동 이동하여 등록 및 로그인을 안내하며, 로그인 및 등록 후 현재 페이지로 자동 돌아옵니다.
최초 신청 시 무료 할당량이 제공되며, Ace Data Cloud의 모델 서비스를 무료로 체험할 수 있습니다.
Ace Data Cloud 배포 및 구성
Open WebUI는 환경 변수를 통해 OpenAI 호환 엔드포인트에 연동하며, Docker 한 줄 명령으로 배포할 수 있습니다({token}을 자신의 Token으로 교체):
http://서버IP:3000을 열면 첫 번째로 등록한 계정이 자동으로 관리자가 됩니다. Base URL의 경로 규칙에 유의하세요:
로그인 후 Admin Panel → Settings → Connections로 이동하여 「Verify Connection」을 클릭해 검증합니다. Settings → Models에서 자주 사용하는 모델을 필터링하고 Pin할 수 있습니다.
환경 변수를 사용하는 것 외에도 Open WebUI는 인터페이스에서 직접 연결을 추가하는 것을 지원합니다: Admin Settings → Connections로 이동하여 ➕를 클릭하고 URL(https://api.acedata.cloud/v1) 및 API Key를 입력하면 됩니다. Open WebUI는 자동으로/models를 호출하여 모델 목록을 가져옵니다. 자세한 내용은 공식 문서 Starting With OpenAI-Compatible Servers를 참조하세요.
MODEL_ID는 선택 가능한 allow list를 보여 주기 위한 용도로만 사용됩니다. 비워 두면/models가 반환한 모든 모델이 표시됩니다.
모델 선택
모델 카탈로그는 지속적으로 업데이트됩니다. 클라이언트가 자동으로 불러오는 모델 목록을 우선 사용하세요. 수동으로 입력해야 하는 경우 먼저GET https://api.acedata.cloud/v1/models를 요청하여 현재 모델 ID를 가져온 후, 클라이언트가 지원하는 컨텍스트, 이미지 및 도구 호출 기능에 따라 선택하세요.
연동 검증
문제가 Open WebUI에 있는지 네트워크에 있는지 확실하지 않다면, 먼저 curl로 엔드포인트를 직접 검증할 수 있습니다({token}을 자신의 Token으로 교체):
chat.completion 객체가 반환되면 Token과 엔드포인트가 모두 준비되었음을 의미합니다. HTTP 403 used_up이 반환되면 Token은 유효하지만 잔액이 부족하다는 의미이므로 콘솔에서 충전하면 됩니다.
고급: 지식 베이스 및 다중 사용자
Open WebUI의 지식 베이스(RAG)는 기본적으로 ChromaDB를 사용하여 벡터를 저장하며, 임베딩 모델로text-embedding-3-large(Ace Data Cloud를 통해)를 지정할 수 있습니다. 문서 원문은 자신의 서버에만 존재하며, 일치한 조각만 모델로 전송됩니다. Admin Panel → Users에서 사용자 역할(Pending / User / Admin)을 관리할 수 있습니다. 「Default User Role」을 pending으로 설정하는 것이 좋으며, 새 사용자는 검토 후에만 사용할 수 있어 외부인이 임의로 등록하여 할당량을 소모하는 것을 방지할 수 있습니다. nginx 리버스 프록시를 사용하는 경우 proxy_buffering off; 및 client_max_body_size 100M;를 추가하세요.
자주 묻는 질문
Connection error / 404가 표시됨
일반적으로OPENAI_API_BASE_URL을 .../openai/v1로 작성했거나 /v1을 누락한 경우입니다. https://api.acedata.cloud/v1로 변경하세요.
문서 업로드 후 대화할 수 없음
Admin Panel의 RAG 설정에서 임베딩 모델을text-embedding-3-large(OpenAI provider)로 선택하세요.
컨테이너 재시작 후 데이터가 사라짐
시작할 때 데이터 볼륨-v open-webui:/app/backend/data를 마운트해야 합니다.