Chatbox AI

​

빠른 시작

​

다운로드 및 설치

• 데스크톱: Windows, macOS, Linux
• 모바일: iOS, Android
• 웹: 브라우저에서 직접 접속

​

APIYI 구성

​

1단계: 설정 열기

1. Chatbox AI 애플리케이션을 실행합니다
2. 왼쪽 아래 모서리의 설정 아이콘(⚙️)을 클릭합니다
3. “Model Configuration” 화면으로 들어갑니다

​

2단계: 사용자 지정 공급자 추가

1. “Model Provider” 섹션에서 + Add 버튼을 클릭합니다
2. 공급자 정보를 입력합니다:
   • Name: APIYI(사용자 지정 가능 이름)
   • API Mode: OpenAI API 호환 선택
   • API Key: APIYI 키를 입력합니다
   • API Host: https://api.apiyi.com/v1
   • API Path: /chat/completions(기본값)
3. 고급 구성(선택 사항):
   • “네트워크 호환성 향상” 옵션을 활성화합니다(그림과 같이)
   • 전용 이미지 생성 엔드포인트를 구성할 수 있습니다

​

3단계: 모델 선택

​

지원되는 모델

​

모델 지원

• GPT 시리즈: GPT-5 시리즈, GPT-4o, gpt-4.1, o3 등
• Claude 시리즈: Claude 4 Sonnet, Claude 3.5 Haiku 등
• Gemini 시리즈: Gemini 2.5 Pro, Gemini 2.5 Flash 등
• 주요 모델: 추론, 비전 이해, 코드 생성 특화 모델

​

핵심 기능

​

다중 플랫폼 동기화

• 로컬 저장소: 데이터가 완전히 로컬에 저장되어 프라이버시를 보호합니다
• 크로스 플랫폼 접근: 서로 다른 기기 간에 전환할 수 있습니다
• 오프라인 기능: 일부 기능은 오프라인 사용을 지원합니다

​

대화 관리

• 다중 턴 대화 컨텍스트 유지
• 대화 기록 검색 및 관리
• 대화 내보내기(Markdown, PDF)
• prompt 라이브러리와 메시지 참조

​

문서 처리

• PDF, TXT, DOCX 문서 업로드
• 이미지 이해 및 분석
• LaTeX 및 Markdown 렌더링
• 코드 하이라이팅 및 미리보기

​

이미지 생성

• DALL-E 시리즈 모델 이미지 생성을 지원합니다
• 구성 가능한 전용 이미지 생성 엔드포인트
• 다양한 이미지 크기와 스타일을 지원합니다
• 배치 이미지 생성 기능

1. 설정에서 전용 이미지 생성 공급자를 추가합니다
2. 표준 /images/generations 엔드포인트를 사용합니다
3. 채팅에서 이미지 요구사항을 직접 설명합니다
4. 시스템이 자동으로 이미지 생성 API를 호출합니다

​

고급 설정

Conversation Parameter Settings:
  - Temperature: 0.7        # Creativity control (reasoning models GPT-5 only use 1)
  - Max Tokens: 4096       # Maximum output length
  - Top P: 0.9            # Sampling parameter (reasoning models gpt-5 only use 1)
  - Context Length: 8192   # Context length

​

사용 팁

​

Prompt 최적화

# Programming Assistant
You are an experienced software engineer, please help me:
- Write high-quality code
- Explain complex concepts
- Provide best practice recommendations

# Output Format
Please format code using code blocks and provide detailed comments.

​

개인정보 보호

• 데이터는 로컬에 저장되며 클라우드로 업로드되지 않습니다
• 자체 호스팅 API 엔드포인트를 지원합니다
• 로컬 모델을 사용해 완전히 오프라인으로 사용할 수 있습니다

​

고급 구성

​

사용자 지정 API 엔드포인트

​

Chat Completion 엔드포인트 구성

Basic Chat Configuration:
  Provider Name: APIYI
  API Mode: OpenAI API Compatible
  API Key: sk-your-apiyi-key
  API Host: https://api.apiyi.com/v1
  API Path: /chat/completions

​

이미지 생성 엔드포인트 구성

Image Generation Configuration:
  Provider Name: APIYI-Image
  API Mode: OpenAI API Compatible
  API Key: sk-your-apiyi-key
  API Host: https://api.apiyi.com/v1
  API Path: /images/generations  # Standard image generation endpoint
  Applicable Models: gpt-image-1, flux-kontext-pro

Responses Configuration:
  Provider Name: APIYI-Responses
  API Mode: OpenAI API Compatible
  API Key: sk-your-apiyi-key
  API Host: https://api.apiyi.com
  API Path: /v1/responses  # General response endpoint

​

네트워크 프록시 설정

1. 설정 > 네트워크 구성으로 이동합니다
2. HTTP/HTTPS 프록시를 구성합니다
3. 프록시 인증을 설정합니다(필요한 경우)

​

키보드 단축키 설정

• Ctrl/Cmd + N: 새 대화
• Ctrl/Cmd + T: 모델 전환
• Ctrl/Cmd + /: 명령 팔레트 표시
• Ctrl/Cmd + K: 빠른 검색

​

모바일 설정

​

iOS/Android 설정

1. Chatbox AI 모바일 앱을 다운로드합니다
2. Settings > Model Configuration으로 이동합니다
3. APIYI 사용자 지정 프로바이더를 추가합니다
4. 동일한 API Base URL 및 키를 구성합니다

​

모바일 전용 기능

• 음성 입력: 음성을 텍스트로 변환할 수 있습니다
• 카메라 통합: 이미지 분석을 위해 직접 사진을 촬영할 수 있습니다
• 오프라인 캐시: 대화 기록을 오프라인에서 확인할 수 있습니다
• 푸시 알림: 중요한 메시지 알림입니다

​

문제 해결

​

일반적인 문제

• API 기본 URL 확인: https://api.apiyi.com/v1
• API key 유효성을 확인하십시오
• 네트워크 연결이 정상인지 확인하십시오

• 모델 목록이 자동으로 새로 고침될 때까지 기다리십시오
• 수동으로 “모델 새로 고침” 버튼을 클릭하십시오
• API key 권한을 확인하십시오

• 더 빠른 모델로 전환해 보십시오
• 네트워크 지연 시간을 확인하십시오
• 컨텍스트 길이를 줄이십시오

​

로그 디버깅

1. 설정 > 고급 옵션
2. “디버그 모드”를 활성화하십시오
3. 상세 로그 정보를 확인하십시오

​

데이터 백업

1. 설정 > 데이터 관리
2. 대화 기록을 내보내십시오
3. 구성 파일을 백업하십시오

​

모범 사례

​

성능 최적화

1. 모델을 현명하게 선택합니다
   • 단순한 작업에는 gpt-4.1을 사용합니다
   • 복잡한 작업에는 o3, gpt-5 시리즈를 사용합니다
   • 긴 텍스트에는 Claude 4, gemini-2.5-pro 시리즈를 사용합니다
2. 컨텍스트 관리
   • 사용하지 않는 대화는 정기적으로 정리합니다
   • 컨텍스트 길이를 적절하게 설정합니다
   • 대화 그룹화 기능을 사용합니다
3. 리소스 관리
   • API 사용량을 모니터링합니다
   • 사용 쿼터 알림을 설정합니다
   • 앱 버전을 정기적으로 업데이트합니다

​

보안 권장 사항

• API 키를 공유하지 않습니다
• 키를 정기적으로 변경합니다
• 강력한 비밀번호로 앱을 보호합니다
• 민감한 정보는 신중하게 처리합니다

​

팀 협업

• prompt 템플릿을 공유합니다
• 대화 기록을 내보내고 공유합니다
• API 구성 표준을 통일합니다

​

비교 장점

​

다른 클라이언트 대비

​

Chatbox AI를 선택하는 이유

1. 개인정보 우선: 데이터가 완전히 로컬에 저장됩니다
2. 유연한 구성: 다양한 API 엔드포인트를 지원합니다
3. 크로스 플랫폼: 통합된 사용자 경험을 제공합니다
4. 풍부한 기능: prompt 라이브러리, 문서 처리 등
5. 지속적인 업데이트: 활발한 개발과 유지보수가 이루어집니다