Quick Start
Download and Install
Chatbox AI supports multi-platform installation:- Desktop: Windows, macOS, Linux
- Mobile: iOS, Android
- Web: Direct access through browser
Configure Laozhang API
Step 1: Open Settings
- Launch the Chatbox AI application
- Click the settings icon (⚙️) in the lower left corner
- Enter the “Model Configuration” interface
Step 2: Add Custom Provider

- Click the + Add button in the “Model Provider” section
-
Fill in provider information:
- Name: Laozhang API (customizable name)
- API Mode: Select OpenAI API Compatible
- API Key: Enter your Laozhang API key
- API Host:
https://api.laozhang.ai/v1
- API Path:
/chat/completions
(default value)
-
Advanced Configuration (optional):
- Enable “Improve network compatibility” option (as shown)
- Can configure dedicated image generation endpoint
Configuration Key Points
- The API Host field corresponds to Base URL and must include the
/v1
suffix - The API Path field is used to specify the specific endpoint path
- API keys can be obtained from Laozhang API Console
- After configuration, click the + New button in the lower right to add models
Step 3: Select Models
After configuration, you can select the following models in the chat interface:Supported Models
Model Support
Chatbox AI supports various mainstream AI models through Laozhang API, including:- 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
View Complete Model List
For detailed model information, pricing, and feature comparison, please visit the Model Information Page
Core Features
Multi-platform Sync
Chatbox AI’s core advantages:- Local Storage: Data is completely stored locally, protecting privacy
- Cross-platform Access: Switch between different devices
- Offline Features: Some features support offline use
Conversation Management
Smart Conversation Features:- Multi-turn conversation context retention
- Conversation history search and management
- Conversation export (Markdown, PDF)
- Prompt library and message references
Document Processing
Document Understanding Capabilities:- PDF, TXT, DOCX document upload
- Image understanding and analysis
- LaTeX and Markdown rendering
- Code highlighting and preview
Image Generation
AI Image Creation:- Supports DALL-E series model image generation
- Can configure dedicated image generation endpoint
- Supports various image sizes and styles
- Batch image generation feature
- Add dedicated image generation provider in settings
- Use standard
/images/generations
endpoint - Describe image requirements directly in chat
- System automatically calls image generation API
Advanced Settings
Parameter Adjustment:Usage Tips
Prompt Optimization
Chatbox AI has built-in prompt library, and you can also create custom prompts:Privacy Protection
Chatbox AI adopts a “privacy by design” philosophy:- 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
In addition to basic chat functionality, you can also configure dedicated image generation endpoints:Chat Completion Endpoint Configuration
Image Generation Endpoint Configuration
Method 1: Use Dedicated Image APIEndpoint Selection Recommendations
- Regular conversation: Use
/chat/completions
endpoint - Reverse image generation models like sora_image: Use
/chat/completions
endpoint - Image generation: Prioritize
/images/generations
standard endpoint - Special needs: Can use
gpt-image-1
or/v1/responses
endpoint - In Chatbox, the “API Path” field corresponds to the specific endpoint path
Network Proxy Settings
If you need to use a proxy to access:- Go to Settings > Network Configuration
- Configure HTTP/HTTPS proxy
- Set proxy authentication (if needed)
Keyboard Shortcuts
Common shortcuts:Ctrl/Cmd + N
: New conversationCtrl/Cmd + T
: Switch modelCtrl/Cmd + /
: Show command paletteCtrl/Cmd + K
: Quick search
Mobile Configuration
iOS/Android Configuration
Mobile configuration is the same as desktop:- Download Chatbox AI mobile app
- Go to Settings > Model Configuration
- Add Laozhang API custom provider
- 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 Caching: Conversation history available offline
- Push Notifications: Important message alerts
Troubleshooting
Common Issues
Connection Failed- Check API Base URL:
https://api.laozhang.ai/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
Debug Logging
Enable debug mode:- Settings > Advanced Options
- Turn on “Debug Mode”
- View detailed log information
Data Backup
Regularly backup conversation data:- Settings > Data Management
- Export conversation history
- Backup configuration files
Best Practices
Performance Optimization
-
Choose Models Wisely
- Simple tasks use gpt-4.1
- Complex tasks use o3, gpt-5 series
- Long text use Claude 4, gemini-2.5-pro series
-
Context Management
- Regularly clean up unused conversations
- Set context length appropriately
- Use conversation grouping feature
-
Resource Management
- Monitor API usage
- Set usage limit reminders
- Regularly update app version
Security Recommendations
- Do not share API keys
- Regularly rotate keys
- Use strong passwords to protect the app
- Handle sensitive information carefully
Team Collaboration
Although Chatbox AI is primarily for individual users, you can support teams through:- Share prompt templates
- Export and share conversation records
- Unify API configuration standards
Comparison Advantages
vs Other Clients
Feature | Chatbox AI | ChatGPT Web | Other Clients |
---|---|---|---|
Local Storage | ✅ | ❌ | Partial Support |
Multi-platform | ✅ | ❌ | Partial Support |
Custom API | ✅ | ❌ | ✅ |
Offline Features | ✅ | ❌ | ❌ |
Privacy Protection | ✅ | ❌ | Uncertain |
Reasons to Choose Chatbox AI
- Privacy First: Data completely stored locally
- Flexible Configuration: Supports various API endpoints
- Cross-platform: Unified user experience
- Feature Rich: Prompt library, document processing, etc.
- Continuous Updates: Active development and maintenance