Cherry Studio / Chatbox

Prepare

Use a gateway root, a virtual key with model access and a public model name. Test GET /v1/models first.

Configure

Create an OpenAI-compatible provider in settings, enter the gateway URL and virtual key, fetch models or add the public name manually, then select it in an assistant. Some clients append /v1 automatically: inspect their URL preview.

Verify and troubleshoot

Send “Hello, introduce yourself.” and inspect the call ID in XHub request logs. Verify streaming, tool calls and images separately against deployment capabilities. For 401 check the virtual key; for 403 check model scope; for 404 check the URL and duplicated /v1. Client settings vary by version.