All guides / Chat clients

Use XHuoAPI in Cherry Studio

Cherry Studio has said it will not bundle more gateway-type providers; they are added as a custom provider instead. The setup mirrors the built-in OpenAI provider.

Before you start

Sign up in the console and create an API token. Registration needs an email address only, no phone number.
You pick a tier when creating the token; new accounts default to Standard. The tier sets price and stability and also which models are available — see the pricing page.

Verify first

Before touching the tool, confirm the key and model work with curl. This rules out half of the 'I configured it and nothing happens' cases.

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

Steps

Settings → Model Services, click + Add at the bottom. Any name; set the provider type to OpenAI.

Enter the API key and API address. Cherry Studio appends /v1/chat/completions itself, so the address is just the domain.

API 地址 / API address:  https://api.xhuoapi.ai
API 密钥 / API key:      sk-...

Click Get model list, then in the Model Management popup click + next to each model you want. Only added models appear in selectors across the app. Finally flip the enable switch at the top right.

Notes

If the address ends with #, Cherry Studio stops appending the path and uses exactly what you typed. You rarely need this unless the upstream path is non-standard.

The real upstream ID is shown under each model name. Similar-looking versions are not merged, so check the ID before adding.

Qwen models and image/video models are only available in the Standard and Official tiers. A token created in the Saver or Spot tier will get a 'model not available' error for them.

Commonly used models

These are common choices for this kind of tool; click a model to see its price in each tier. The full list is on the pricing page.

deepseek-v3.2 qwen3.8-max gemini-3.7-flash claude-sonnet-5 gpt-5.4-mini

Steps follow the tool's current official documentation; the UI may change after updates. Tell us if something no longer matches.