> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/pre-basic/providers.md).

# Model Services

Cherry Studio has built-in connection templates for 60+ providers (model service providers), covering most mainstream models and local inference frameworks at home and abroad. This section provides an independent configuration guide for each provider.

### Provider Types

Cherry Studio divides providers into the following categories by protocol, with slightly different behavior:

| Type                     | Compatible Protocol          | Typical Examples                                                       |
| ------------------------ | ---------------------------- | ---------------------------------------------------------------------- |
| **OpenAI compatible**    | `/v1/chat/completions`       | OpenAI, DeepSeek, SiliconFlow, OpenRouter, most third-party gateways   |
| **Anthropic compatible** | `/v1/messages`               | Anthropic, CherryIN, some gateways.**Cherry Agent requires this type** |
| **Gemini**               | Google AI Studio / Vertex    | Google Gemini, Vertex AI                                               |
| **Bedrock**              | AWS Bedrock SDK              | AWS Bedrock                                                            |
| **Azure OpenAI**         | Azure OpenAI Service         | Azure OpenAI                                                           |
| **Local inference**      | Local HTTP service           | Ollama, LM Studio, GPUStack, OpenVINO Model Server                     |
| **Special gateways**     | Vendor proprietary protocols | NewAPI, OneAPI, AiHubMix, DMXAPI, etc.                                 |

### General steps to add a Provider

1. After opening `Settings → Model Services`
2. Find the target Provider in the built-in Provider list and click to enter the details page
3. Fill in **API key**(required), modify as needed **API Address**(the default is the Provider's official address)
4. Click **Get model list**, and add your commonly used chat/embedding/vision models as needed
5. (optional) click **Test**, and use any chat model to verify whether the connection is successful

### Provider Configuration Details

#### General/Gateway category

* [CherryAI (Free)](/docs/en-us/pre-basic/providers/cherryai.md)
* [CherryIN](/docs/en-us/pre-basic/providers/cherryin-1.md) — Dual endpoints (OpenAI + Anthropic), recommended for Cherry Agent
* [NewAPI](/docs/en-us/pre-basic/providers/newapi.md) / [OneAPI](/docs/en-us/pre-basic/providers/oneapi.md) — Self-hosted/third-party gateway

#### Overseas vendors

* [OpenAI](/docs/en-us/pre-basic/providers/openai.md)
* [Google Gemini](/docs/en-us/pre-basic/providers/google-gemini.md)
* [Vertex AI](/docs/en-us/pre-basic/providers/vertex-ai.md)
* [Mistral](/docs/en-us/pre-basic/providers/mistral.md)
* [Perplexity](/docs/en-us/pre-basic/providers/perplexity.md)
* [GitHub Copilot](/docs/en-us/pre-basic/providers/github-copilot.md)
* [MiniMax Coding Plan](/docs/en-us/pre-basic/providers/minimax-coding-plan.md)

#### Domestic vendors

* [Alibaba Cloud Bailian](/docs/en-us/pre-basic/providers/a-li-yun-bai-lian.md)
* [Zhipu AI](/docs/en-us/pre-basic/providers/zhipu.md)
* [SiliconFlow](/docs/en-us/pre-basic/providers/siliconcloud.md)
* [Volcano Engine (Doubao)](/docs/en-us/pre-basic/providers/doubao.md)
* [PPIO](/docs/en-us/pre-basic/providers/ppio.md)
* [ModelScope (ModelScope)](/docs/en-us/pre-basic/providers/modelscope.md)

#### Local inference

* [Ollama](/docs/en-us/pre-basic/providers/ollama.md)

#### Custom providers

* [Custom providers](/docs/en-us/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) — Any OpenAI / Anthropic / Gemini compatible endpoint

{% hint style="info" %}
**What if you can't find the Provider you use?**

Cherry Studio has built-in 60+ provider templates, but **far more than the number included in this section's documentation** If you're using Anthropic (Claude), Azure OpenAI, official DeepSeek, Grok, Groq, LM Studio, OpenRouter, Mistral, Perplexity, Together, etc.,**they are all in the Provider list**, just add the API key directly. This section will gradually add dedicated pages for these providers.
{% endhint %}

### API keys and API addresses

See [model service settings](/docs/en-us/pre-basic/providers/providers.md)(including multi-Key polling,`#` advanced usage such as fixed paths at the end).

***

### Get help and submit feedback

If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](/docs/en-us/question-contact/suggestions.md) for the official channels provided.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/en-us/pre-basic/providers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.