跳转到主要内容
Cherry Studio connects to Qhaigc through a custom provider in Model Services. Because Cherry Studio requires you to maintain the model list manually, this tutorial walks through both adding the provider and registering the models you want to use.

​
Prerequisites

  • Cherry Studio desktop app (a version that supports custom model services)
  • A Qhaigc API key — get yours from the API Tokens page

​
Configure the Provider

1

Open Model Services settings

Launch Cherry Studio, open Settings, then navigate to Model Services.
2

Add a new provider

Click Add (or +) to create a new provider entry.
  • Set a Provider Name of your choice (for example, Qhaigc).
  • Set Provider Type to OpenAI.
3

Enter your Qhaigc credentials

Fill in the following fields:
FieldValue
API KeyYour Qhaigc API key (starts with sk-)
API addresshttps://api.qhaigc.net/v1
Leave the model management section empty for now. Save the provider.
4

Add models in Model Management

Open Model Management for the provider you just created. Manually add the ID of each model you want to use (for example, gpt-4o or claude-3-5-sonnet-20241022).Save the model list when you are done.
5

Start chatting

Return to the chat view, select your new Qhaigc provider, choose a model, and send a test message.

​
Verify the Connection

  • Click the validation button next to your API key to confirm connectivity.
  • Send a test message in a new chat. A successful reply confirms the provider is working.
Models do not appear automatically in Cherry Studio’s custom provider flow. If the model list looks empty, go back to Model Management and confirm that you have added at least one model ID.

​
Troubleshooting

Validation test fails. Double-check the API key, the API address, and that the Provider Type is set to OpenAI. Different UI labels. Exact field names may vary between Cherry Studio versions, but the core flow — custom provider, Provider Type: OpenAI, manual model list — remains the same.