Using Ace Data Cloud 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 Ace Data Cloud 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 Ace Data Cloud in ChatBox, first go to the Ace Data Cloud 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 inviting 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 Ace Data Cloud's model services for free.

Download ChatBox

Go to 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 Ace Data Cloud

Launch ChatBox, go to Settings → Models, select OpenAI API for "Model Provider" (do not select Azure or Custom), and then fill in:

Field Value Description
API Key Your Ace Data Cloud 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 Models" input box at the bottom of the model settings page (one per line), and after saving, you can select it from the model dropdown in the chat interface.

The following model IDs have been verified as available through Ace Data Cloud GET /v1/models and POST /v1/chat/completions:

Family Model ID Notes
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-k2.5 Long text

For a complete list of models, please refer to the Ace Data Cloud 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 Ace Data Cloud Token (without the Bearer prefix and no extra spaces), and that the associated application has sufficient balance.

ChatBox will not automatically pull the model list; you must manually enter the model ID in the "Custom Models" box and save it.

Want to generate images in ChatBox

Ace Data Cloud'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.

Learn More