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

# ModelScope (Moda)

## 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**a one-stop model service solution, making model application easier!
>
> Through **API-Inference service capabilities**, the platform standardizes open-source models into callable API interfaces, allowing developers to lightweightly and quickly integrate model capabilities into various AI applications, supporting innovative scenarios such as tool calling and prototype development.

### Core advantages

* ✅ **Free quota**: Provides daily **2,000 free API calls**([Billing rules](##计费与额度规则))
* ✅ **Rich model library**: Covers 1,000+ open-source models across NLP, CV, speech, multimodal, and more
* ✅ **Ready to use out of the box**: No deployment required, call quickly through 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**Log in** → choose an authentication method ![登录界面](/files/4198aee182fcf6d59893f3a0181472daecb559ec)
2. **Create an access token**

   * Enter [**Account settings → Access tokens**](https://modelscope.cn/my/myaccesstoken)

   * Click **`Create new token`** → fill in a description → **Copy the generated token**(*See the example page below*) ![新建令牌示例](/files/5e70b0b80e52449a58cc494fa17f144e0910f510)

   > 🔑 **Important note**: Token leakage will compromise account security!

### Step 2: Configure Cherry Studio

* Open **Cherry Studio** → **Settings → Model services → ModelScope**
* in `API key` Paste the copied token into the field ![配置界面](/files/06612431c538ff08621c251c4f43fbcfab579378)
* Click **`Save`** Complete authorization

### Step 3: Call the model API

1. **Find models that support API**

   * Access [ModelScope model library](https://modelscope.cn/models)

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

   > The range of models covered by API-Inference is mainly determined by the level of attention a model receives in the ModelScope community (based on data such as likes and downloads). Therefore, after a next-generation open-source model with stronger capabilities and higher attention is released, the list of supported models will continue to be updated.
2. **Get the model ID**
   * Enter the target model detail 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 service configuration page, the `Model ID` field, enter the ID → choose the task type → finish 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 00:00 UTC+8,**does not support cross-day accumulation or rollover**
* 💡 **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

### View remaining quota

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

> ⚠️ Note: Inference API-Inference has a free quota of 2,000 calls per day. For more call needs, consider 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) 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.cherry-ai.com/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.