> 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/modelscope.md).

# ModelScope

## What is ModelScope?

> ModelScope is a new-generation open-source model-as-a-service (MaaS) sharing platform, dedicated to providing **flexible, easy-to-use, low-cost** one-stop model service solutions, making model applications easier!
>
> Through **API-Inference service capabilities**, the platform standardizes open-source models into callable API interfaces, allowing developers to quickly and lightly integrate model capabilities into various AI applications, supporting innovative scenarios such as tool calling and prototype development.

### Core Advantages

* ✅ **Free quota**: Daily provides **2,000 free API calls**([Billing rules](#计费与额度规则))
* ✅ **Rich model library**: Covers 1000+ open-source models in NLP, CV, speech, multimodal, etc.
* ✅ **Ready to use**: No deployment required, quickly call via RESTful API

***

## Cherry Studio integration process

### Step 1: Get a ModelScope API token

1. **Log in to the platform**
   * Access [ModelScope official website](https://modelscope.cn) → Click the top right corner **Log in** → Choose authentication method ![登录界面](/files/4198aee182fcf6d59893f3a0181472daecb559ec)
2. **Create access token**

   * Go to [**Account Settings → Access Token**](https://modelscope.cn/my/myaccesstoken)

   * Click **`New Token`** → Fill in description → **Copy the generated token**(*See example on the page below*) ![新建令牌示例](/files/5e70b0b80e52449a58cc494fa17f144e0910f510)

   > 🔑 **Important reminder**: Token leakage will affect account security!

### Step 2: Configure Cherry Studio

* After opening **Cherry Studio** → **Settings → Model Services → ModelScope**
* Switch between `API key` Paste the copied token in the field ![配置界面](/files/06612431c538ff08621c251c4f43fbcfab579378)
* Click **`Save`** Authorization completed

### Step 3: Call the model API

1. **Find models that support API**

   * Access [ModelScope Model Hub](https://modelscope.cn/models)

   * Filter criteria:**Check `API-Inference`**(or identify the `API` icon ![API 模型筛选](/files/e3f0f60ca0bb82cf370f384ac2b173424d91c5e8)

   > The range of models covered by API-Inference is mainly determined based on the level of attention the model receives in the ModelScope community (referring to data such as likes and downloads). Therefore, after the release of next-generation open-source models with stronger capabilities and higher attention, the list of supported models will continue to evolve.
2. **Get the model ID**
   * Go to the target model details page → copy **Model ID**(format such as `damo/nlp_structbert_sentiment-classification_chinese-base`) ![复制 Model ID](/files/e0e1797e3e975ed5f89704c0264e00065455d5ce)
3. **Fill in Cherry Studio**
   * On the model services configuration page `Model ID` Enter the ID in the field → Select the task type → Complete configuration ![填入模型 ID](/files/e5c41261f2c003a6ecb18ee7f88974fb6f6c203d)

***

## Billing and quota rules

### Important note

* 🎫 **Free quota**: Each user **2,000 API calls per day**(\*subject to the latest rules on the official website)
* 🔁 **Quota reset**: Automatically resets daily at UTC+8 00:00,**no cross-day accumulation or carryover supported**
* 💡 **Over-limit handling**:
  * After reaching the daily limit, the API will return `429 error`
  * Solution: Switch to a backup account / Use another platform / Optimize call frequency

### Check remaining quota

* Log in to ModelScope → Click the top right corner **`username`** → **`API usage`** ![额度查看位置](/files/b04f597538f539cb3754b9d4ee83c038fb107f74)

> ⚠️ Note: The inference API-Inference has a free quota of 2,000 calls per day. For more calling needs, consider using cloud services such as Alibaba Cloud BaiLian.

***

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