Using 华烁云 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 华烁云 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 华烁云 in ChatBox, first go to the 华烁云 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.

A free quota will be provided upon your first application, allowing you to experience 华烁云's model services for free.

Download ChatBox

Go to the ChatBox official website to download by platform, or directly use the no-install Web version:

  • 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 华烁云

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 华烁云 Token Token copied from the console
API Host https://hsyunapi.hszl-bd.cn 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 for Host:

API Host Final Request Result
https://hsyunapi.hszl-bd.cn https://hsyunapi.hszl-bd.cn/v1/chat/completions Correct
https://hsyunapi.hszl-bd.cn/openai https://hsyunapi.hszl-bd.cn/openai/v1/chat/completions 404 (/openai does not have /v1)
https://hsyunapi.hszl-bd.cn/openai/v1 https://hsyunapi.hszl-bd.cn/openai/v1/v1/chat/completions 404

ChatBox will not automatically call /v1/models, you need to manually enter the model ID (one per line) in the "Custom Models" input box at the bottom of the model settings page, and save it to select from the model dropdown in the chat interface.

The following model IDs have been verified as available through 华烁云 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-preview, 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, ultra-long context

For a complete list of models, please refer to the 华烁云 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://hsyunapi.hszl-bd.cn/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://hsyunapi.hszl-bd.cn, and the path should default to /v1/chat/completions.

Prompt 401 / token_mismatched

Please confirm that the "API Key" pasted is the 华烁云 Token (without the Bearer prefix and no extra spaces), and that the balance of the associated application is sufficient.

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

华烁云'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