Chatbox AI
Chatbox AI를 설치하고, RunAPI 사용자 정의 공급자를 추가하고, 모델을 가져오고, 연결 확인을 실행하고, 채팅을 확인합니다.
사용자 지정 BYOK 공급자로 Chatbox AI를 RunAPI에 연결합니다. 아래 이름은 현재 사용자 지정 공급자 인터페이스를 따르며, 레이블은 데스크탑 릴리스에 따라 약간 다를 수 있습니다. 계속하기 전에 인증 가이드에서 표준 RunAPI API 키를 만드십시오.
Chatbox AI 설치
공식 다운로드 페이지 또는 공식 릴리스에서 Chatbox AI를 다운로드하여 설치한 후 설정을 여세요.
RunAPI 제공자 추가
- AI 제공자 / 모델 설정을 열고 제공자 추가를 선택합니다.
- 이름을
RunAPI로 지정하고 API 모드로 OpenAI API 호환을 선택합니다. - RunAPI API 키를 입력합니다.
- API 호스트를
https://runapi.ai/v1으로, API 경로를/chat/completions로 설정합니다. - URL 미리보기가
https://runapi.ai/v1/chat/completions로 끝나는지 확인한 후 저장합니다.
Host와 Path를 별도로 유지하세요. Fetch는 Host에 /models를 추가하여 모델 검색을 구성하고, 채팅은 Host와 구성된 API Path를 사용합니다.
모델 추가 및 확인
가져오기를 선택하여 RunAPI 모델 목록을 불러오세요. 검색이 불가능한 경우 새로 만들기를 선택하고 모델 카탈로그에서 정확한 식별자를 입력하세요. Chatbox AI는 확인을 실행하기 전에 저장된 모델이 하나 이상 필요합니다.
확인을 선택하고 저장된 모델을 선택한 후 연결 테스트를 실행하세요. 성공적인 텍스트 요청을 기준 신호로 삼으세요. 비전 요청과 도구 사용 요청은 선택한 모델의 기능에 따라 달라지며, 기본 텍스트 채팅을 무효화하지 않고 독립적으로 실패할 수 있습니다.
연결 확인
새 채팅을 시작하고 모델 선택기에서 저장된 RunAPI 모델을 선택한 후 Reply with the word connected.를 전송하세요. 정상적인 응답은 커스텀 공급자가 활성화되어 있음을 확인합니다.
문제 해결
- URL 미리보기가 잘못됨: Host에
https://runapi.ai/v1을, Path에/chat/completions을 사용하세요. 두 필드 모두에 전체 작업 URL을 입력하지 마세요. - 확인이 비활성화되어 있거나 모델이 없음: Fetch 또는 New를 사용하여 모델을 먼저 하나 이상 추가하세요.
- Text Request에서 인증 오류 발생: 인증 가이드에서 발급한 유효한 표준 키로 공급자를 업데이트하세요.
- Text는 작동하지만 Vision 또는 Tool Use 실패: Model Catalog에서 필요한 기능을 선언하는 모델을 선택하세요. 이러한 확인 사항은 범용 공급자 요구 사항이 아닙니다.
공유 프로토콜 동작에 대해서는 LLM API 빠른 시작을 참조하세요. 요청 및 응답 필드에 대해서는 Chat Completions API 참조를 참조하세요.