Using YuJun in ChatBox
ChatBox is an open-source cross-platform AI client that synchronizes across Windows, macOS, Linux, iOS, Android, and Web with a focus on "minimalism, cross-platform, and local-first." It natively supports custom service providers of the "OpenAI API" type, allowing direct access to YuJun without additional plugins. One API Token can access over 60 large models including Claude, GPT, Gemini, Grok, DeepSeek, Kimi, GLM, etc. This article describes the configuration process.
¶ Application Process
To integrate YuJun in ChatBox, first go to the YuJun Console to obtain your API Token for backup.
If you are not logged in or registered, you will be automatically redirected to the login page to invite you to register and log in. After logging in or registering, you will be automatically returned to the current page.
There is a free quota available for first-time applicants, allowing you to experience YuJun's model services for free.
¶ Download ChatBox
Visit the ChatBox official website to download by platform, or use the portable Web version directly:
- Desktop: Windows
.exe, macOS.dmg(distinguishing Intel / Apple Silicon), Linux AppImage - Mobile: App Store, Google Play, direct link for Android on the official website
¶ Configure YuJun
Launch ChatBox and go to Settings → Model, select OpenAI API for "Model Provider" (do not select Azure or Custom), then fill in:
| Field | Value | Description |
|---|---|---|
| API Key | Your YuJun Token | Token copied from the console |
| API Host | https://api.acedata.cloud |
Only fill in the root domain, do not include /openai or /v1 |
| API Path | /v1/chat/completions |
ChatBox defaults to /chat/completions, must be manually changed to this |
The request path for ChatBox is {API Host} + {API Path}, so only the root domain should be filled in:
| API Host | Final Request | Result |
|---|---|---|
https://api.acedata.cloud |
https://api.acedata.cloud/v1/chat/completions |
Correct |
https://api.acedata.cloud/openai |
https://api.acedata.cloud/openai/v1/chat/completions |
404 (/openai does not have /v1) |
https://api.acedata.cloud/openai/v1 |
https://api.acedata.cloud/openai/v1/v1/chat/completions |
404 |
ChatBox will not automatically call /v1/models, you need to manually enter the model ID in the "Custom Model" input box at the bottom of the model settings page (one per line), and save it to select from the model dropdown in the chat interface.
¶ Recommended Models
The following model IDs have been verified as available through YuJun GET /v1/models and POST /v1/chat/completions:
| Family | Model ID | Note |
|---|---|---|
| GPT | gpt-5, gpt-5-mini, gpt-4o |
OpenAI flagship / cost-effective / classic multimodal |
| Claude | claude-opus-4-8, claude-sonnet-4-6 |
Anthropic flagship / balanced |
| Gemini | gemini-3.1-pro, gemini-3-flash-preview |
Google multimodal / fast |
| Grok | grok-4 |
xAI, natively connected |
| DeepSeek | deepseek-v3 |
High cost-performance, Chinese-friendly |
| Kimi | kimi-k3 |
Reasoning, vision, long context |
For a complete list of models, please refer to the YuJun service documentation.
¶ Verification of Integration
If you are unsure whether the issue lies with ChatBox or the network, you can first verify the endpoint directly using curl (replace {token} with your Token):
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "ping"}]
}'
If you receive an OpenAI-compatible chat.completion object, it indicates that both the Token and endpoint are ready; if you receive HTTP 403 used_up, it means the Token is valid but the balance is insufficient, and you can recharge at the console.
¶ Frequently Asked Questions
¶ Prompt 404 Not Found
This is usually due to the API Host having added /openai or /v1. The Host should only be https://api.acedata.cloud, and the path should default to /v1/chat/completions.
¶ Prompt 401 / token_mismatched
Please confirm that the "API Key" pasted is the YuJun Token (without the Bearer prefix and no extra spaces), and that the balance of the associated application is sufficient.
¶ Cannot see models in the dropdown
ChatBox will not automatically pull the model list; you must manually enter the model ID in the "Custom Model" box and save it.
¶ Want to generate images in ChatBox
YuJun's image generation is a separate Images API (/openai/images/generations), with a different path from the chat interface, and the image entry in ChatBox cannot be directly connected. For drawing, please refer to the Image Generation API documentation for curl / SDK calls.