> 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 includes connection templates for 60+ providers (model service vendors), covering most mainstream models at home and abroad as well as local inference frameworks. This section provides separate configuration guides for each provider.

### Provider Type

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

| Type                     | Compatible Protocol          | Typical Representatives                                                |
| ------------------------ | ---------------------------- | ---------------------------------------------------------------------- |
| **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. Open `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**(default is the provider's official address)
4. Click **Get model list**, add your commonly used chat/embedding/vision models as needed
5. (optional) click **Detect**, use any chat model to verify whether the connection is successful

### Provider configuration details

#### General/Gateway types

* [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)
* [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)
* [SiliconFlow](/docs/en-us/pre-basic/providers/siliconcloud.md)
* [Volcano Engine (Doubao)](/docs/en-us/pre-basic/providers/doubao.md)
* [Huawei Cloud](/docs/en-us/pre-basic/providers/huawei.md)
* [Infinigence AI](/docs/en-us/pre-basic/providers/wu-wen-xin-qiong.md)
* [PPIO PAI Cloud](/docs/en-us/pre-basic/providers/ppio.md)
* [ModelScope](/docs/en-us/pre-basic/providers/modelscope.md)

#### Local inference

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

#### Custom provider

* [Custom provider](/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're using?**

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

### API keys and API addresses

See [Model service settings](/docs/en-us/pre-basic/settings/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) the official channels provided there.


---

# 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.
