Chatbox AI

​

Quick Start

​

Download and Install

• Desktop: Windows, macOS, Linux
• Mobile: iOS, Android
• Web: Direct browser access

​

Configure APIYI

​

Step 1: Open Settings

1. Launch the Chatbox AI application
2. Click the settings icon (⚙️) in the lower left corner
3. Enter the “Model Configuration” interface

​

Step 2: Add Custom Provider

1. Click the + Add button in the “Model Provider” section
2. Fill in the provider information:
   • Name: APIYI (customizable name)
   • API Mode: Select OpenAI API Compatible
   • API Key: Enter your APIYI key
   • API Host: https://api.apiyi.com/v1
   • API Path: /chat/completions (default value)
3. Advanced Configuration (Optional):
   • Enable “Improve Network Compatibility” option (as shown in the image)
   • Can configure dedicated image generation endpoints

​

Step 3: Select Model

​

Supported Models

​

Model Support

• GPT Series: GPT-5 series, GPT-4o, gpt-4.1, o3, etc.
• Claude Series: Claude 4 Sonnet, Claude 3.5 Haiku, etc.
• Gemini Series: Gemini 2.5 Pro, Gemini 2.5 Flash, etc.
• Featured Models: Reasoning, vision understanding, code generation specialized models

​

Core Features

​

Multi-Platform Sync

• Local Storage: Data completely stored locally, protecting privacy
• Cross-Platform Access: Switch between different devices
• Offline Functionality: Some features support offline use

​

Conversation Management

• Multi-turn conversation context retention
• Conversation history search and management
• Conversation export (Markdown, PDF)
• Prompt library and message references

​

Document Processing

• PDF, TXT, DOCX document upload
• Image understanding and analysis
• LaTeX and Markdown rendering
• Code highlighting and preview

​

Image Generation

• Supports DALL-E series model image generation
• Configurable dedicated image generation endpoints
• Supports various image sizes and styles
• Batch image generation functionality

1. Add dedicated image generation provider in settings
2. Use standard /images/generations endpoint
3. Directly describe image requirements in chat
4. System automatically calls image generation API

​

Advanced Settings

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

​

Usage Tips

​

Prompt Optimization

# 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.

​

Privacy Protection

• Data stored locally, not uploaded to cloud
• Supports self-hosted API endpoints
• Can be used completely offline (with local models)

​

Advanced Configuration

​

Custom API Endpoints

​

Chat Completion Endpoint Configuration

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 Endpoint Configuration

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

​

Network Proxy Settings

1. Go to Settings > Network Configuration
2. Configure HTTP/HTTPS proxy
3. Set proxy authentication (if needed)

​

Keyboard Shortcuts Settings

• Ctrl/Cmd + N: New conversation
• Ctrl/Cmd + T: Switch model
• Ctrl/Cmd + /: Show command palette
• Ctrl/Cmd + K: Quick search

​

Mobile Configuration

​

iOS/Android Configuration

1. Download Chatbox AI mobile app
2. Go to Settings > Model Configuration
3. Add APIYI custom provider
4. Configure the same API Base URL and key

​

Mobile-Specific Features

• Voice Input: Supports voice-to-text
• Camera Integration: Take photos directly for image analysis
• Offline Cache: Conversation history available offline
• Push Notifications: Important message alerts

​

Troubleshooting

​

Common Issues

• Check API Base URL: https://api.apiyi.com/v1
• Verify API key validity
• Confirm network connection is normal

• Wait for model list to auto-refresh
• Manually click “Refresh Models” button
• Check API key permissions

• Try switching to a faster model
• Check network latency
• Reduce context length

​

Log Debugging

1. Settings > Advanced Options
2. Enable “Debug Mode”
3. View detailed log information

​

Data Backup

1. Settings > Data Management
2. Export conversation history
3. Backup configuration files

​

Best Practices

​

Performance Optimization

1. Choose Models Wisely
   • Simple tasks use gpt-4.1
   • Complex tasks use o3, gpt-5 series
   • Long texts use Claude 4, gemini-2.5-pro series
2. Context Management
   • Regularly clean up unused conversations
   • Set context length reasonably
   • Use conversation grouping feature
3. Resource Management
   • Monitor API usage
   • Set usage quota reminders
   • Update app version regularly

​

Security Recommendations

• Don’t share API keys
• Change keys regularly
• Protect app with strong passwords
• Handle sensitive information carefully

​

Team Collaboration

• Share prompt templates
• Export and share conversation records
• Unify API configuration standards

​

Comparison Advantages

​

vs Other Clients

​

Reasons to Choose Chatbox AI

1. Privacy First: Data completely stored locally
2. Flexible Configuration: Supports various API endpoints
3. Cross-Platform: Unified user experience
4. Feature Rich: Prompt library, document processing, etc.
5. Continuous Updates: Active development and maintenance