Skip to main content
Cherry Studio is a desktop client that lets you manage multiple model providers in one interface. The global edition includes AiHubMix as a built-in provider.

Download Cherry Studio

Download Cherry Studio

Configure AIHubMix

  1. Open Settings → Model Provider, select AiHubMix, and turn on the switch in the top-right corner.
    Select AiHubMix in Model Provider
  2. Keep API Host at https://aihubmix.com/v1.
    API Host set to aihubmix.com/v1
  3. Enter the key from this site in API Key and click Model Check.
    Enter the API key and check the connection
    If the check fails, disable your VPN and try again.
  4. Click Sync models to add models from the returned list, or click + to add a model ID manually.
    Sync models or add a model manually
    Add Model window with Model ID and Model Name
  5. Open Settings → Default Model and choose the models used for the assistant, quick tasks, and translation.
    Choose the default models

Start chatting

Return to the home page and select the added model in the model selector at the top.

FAQ

The model cannot recognize images

Open the model’s edit page under Settings → Model Provider and enable Vision under Input Modalities.

Calling Claude models returns AI_APICallError

Check whether the request URL in the error message is https://aihubmix.com/anthropic/v1/messages. If it is, change the Anthropic endpoint URL to https://aihubmix.com in the provider settings.

Enable Claude prompt caching

Open API Settings on the AiHubMix provider page and configure the options as needed:
  • Cache Token Threshold: only messages above this token count are cached; set to 0 to disable caching
  • Cache System Message: whether to cache the system prompt
  • Cache Last N Messages: cache the last N conversation messages, excluding system messages
  • Cache Duration: 5 minutes or 1 hour; one-hour cache writes cost more
Once enabled, Cherry Studio automatically injects cache_control for Claude models. For details, see Claude Prompt Caching.
Last updated: 2026-11-04