Using 华烁云 in LobeChat

LobeChat is an open-source AI client that features "modern UI + plugin ecosystem + knowledge base + one-click self-deployment." You can use the official online version (PWA) or run a private version on your own server using Docker. It natively supports custom OpenAI-compatible endpoints, allowing access to 华烁云, with one API Token accessing over 60 large models including Claude, GPT, Gemini, Grok, DeepSeek, Kimi, GLM, etc. This article describes the configuration process.

Application Process

To integrate 华烁云 into LobeChat, 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 to invite you to register and log in. After logging in or registering, you will be automatically returned to the current page.

You will receive a free quota upon your first application, allowing you to experience 华烁云's model services for free.

Configuring 华烁云

Go to LobeChat's Application Settings → Language Model, find the OpenAI card and enable it, then fill in:

Field Value Description
API Key Your 华烁云 Token Token copied from the console
API Proxy URL https://hsyunapi.hszl-bd.cn/v1 Must end with /v1
Client Request Mode Enabled Direct browser connection, Key does not go through LobeChat server

LobeChat will not automatically append /v1 to the Base URL, the request path is directly {API Proxy URL}/chat/completions:

API Proxy URL Actual Request Result
https://hsyunapi.hszl-bd.cn/v1 https://hsyunapi.hszl-bd.cn/v1/chat/completions Correct
https://hsyunapi.hszl-bd.cn/openai https://hsyunapi.hszl-bd.cn/openai/chat/completions Also usable
https://hsyunapi.hszl-bd.cn/openai/v1 https://hsyunapi.hszl-bd.cn/openai/v1/chat/completions 404 (/openai does not have /v1)
https://hsyunapi.hszl-bd.cn https://hsyunapi.hszl-bd.cn/chat/completions 404 (missing /v1)

LobeChat will automatically call /v1/models to fetch models, and if 华烁云 returns many models, the interface will be lengthy. It is recommended to manually fill in an allow list in "Model List → Custom Model Name," separated by commas. If you need to customize the display name, you can use =, for example, gpt-5=GPT-5 Flagship Edition.

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

Advanced: Docker Self-Deployment

If you want to deploy a private version for team use, you can start it with a single Docker command (replace {token} with your Token):

docker run -d \
  --name lobe-chat \
  -p 3210:3210 \
  -e OPENAI_API_KEY={token} \
  -e OPENAI_PROXY_URL=https://hsyunapi.hszl-bd.cn/v1 \
  -e ACCESS_CODE=your-secret-password \
  -e OPENAI_MODEL_LIST="gpt-5,claude-opus-4-8,gemini-3.1-pro-preview,grok-4,deepseek-v3" \
  lobehub/lobe-chat:latest

Open http://your-server-IP:3210, enter ACCESS_CODE to use it, and team members do not need to fill in their own Keys. For a complete explanation of the environment variables used above, such as OPENAI_API_KEY, OPENAI_PROXY_URL, OPENAI_MODEL_LIST, see the LobeChat Model Service Provider Environment Variable Documentation. If using nginx for reverse proxy with HTTPS, be sure to add proxy_buffering off;, otherwise, streaming responses will be buffered. For more deployment forms, please refer to LobeChat Self-Deployment Guide and Docker Compose Deployment.

Common Issues

Prompt 404 Not Found

This is usually due to the API proxy URL being written as .../openai/v1 or missing /v1. Change it to https://hsyunapi.hszl-bd.cn/v1.

Model List is Empty

Enable the "Client Request Mode" switch; or manually fill in the model allow list in "Custom Model Name."

Prompt 401 Unauthorized

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.

Learn More