> 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/zhong-wen-fan-ti/pre-basic/providers/modelscope.md).

# ModelScope（魔搭）

## 乜嘢係 ModelScope？

> ModelScope 係新一代開源模型即服務（MaaS）共享平台，致力為泛 AI 開發者提供 **靈活、易用、低成本** 嘅一站式模型服務解決方案，令模型應用更簡單！
>
> 透過 **API-Inference 服務化能力**，平台將開源模型標準化為可呼叫嘅 API 接口，開發者可以輕量、快速咁將模型能力整合到各類 AI 應用，支援工具調用、原型開發等創新場景。

### 核心優勢

* ✅ **免費額度**：每日提供 **2000 次免費 API 調用額度**（[計費規則](#计费与额度规则)）
* ✅ **豐富模型庫**：覆蓋 NLP、CV、語音、多模態等 1000+ 開源模型
* ✅ **即開即用**：唔使部署，透過 RESTful API 快速調用

***

## Cherry Studio 接入流程

### 步驟 1：獲取 ModelScope API 令牌

1. **登入平台**
   * 訪問 [ModelScope 官網](https://modelscope.cn) → 點擊右上角 **登入** → 選擇認證方式 ![登录界面](/files/19e7d3a1b033e5ef9d8b3fda60e6480fd9a7e9ae)
2. **建立存取令牌**

   * 進入 [**帳戶設定 → 存取令牌**](https://modelscope.cn/my/myaccesstoken)

   * 撳 **`新增令牌`** → 填寫描述 → **複製生成嘅令牌**（*頁面示例見下圖*） ![新建令牌示例](/files/9a4c5ed46d493240635d5e31af413ee9df7df145)

   > 🔑 **重要提示**：令牌洩露會影響帳號安全！

### 步驟 2：配置 Cherry Studio

* 打開 **Cherry Studio** → **設定 → 模型服務 → ModelScope**
* 喺 `API 密鑰` 欄貼上複製嘅令牌 ![配置界面](/files/91a9a27441df771b571df86ddb16d2c3d7681a52)
* 撳 **`儲存`** 完成授權

### 步驟 3：調用模型 API

1. **搵支援 API 嘅模型**

   * 訪問 [ModelScope 模型庫](https://modelscope.cn/models)

   * 篩選條件：**剔選 `API-Inference`**（或者認準模型卡片上嘅 `API` 圖示） ![API 模型筛选](/files/e43ce9619e8d589543058202606e0c5041920d6c)

   > API-Inference 涵蓋嘅模型範圍，主要係根據模型喺魔搭社區入面嘅關注程度（參考點讚、下載等數據）嚟判斷。所以，喺能力更強、關注度更高嘅下一代開源模型發布之後，支援嘅模型清單亦會持續迭代。
2. **取得模型 ID**
   * 進入目標模型詳情頁 → 複製 **Model ID**（格式如 `damo/nlp_structbert_sentiment-classification_chinese-base`） ![复制 Model ID](/files/6821c4f8a6d8870242e01a9f9526f9a855db84b3)
3. **填入 Cherry Studio**
   * 喺模型服務配置頁嘅 `模型 ID` 欄輸入 ID → 選擇任務類型 → 完成配置 ![填入模型 ID](/files/b6222cd61b7222aa339dbae618d0ea83591404d0)

***

## 計費同額度規則

### 重要說明

* 🎫 **免費額度**：每位用戶 **每日 2000 次 API 調用**（\*以官網最新規則為準）
* 🔁 **額度重置**：每日 UTC+8 00:00 自動重置，**唔支援跨日累計或升級**
* 💡 **超額處理**：
  * 達到當日上限後 API 會回傳 `429 錯誤`
  * 解決方案：切換備用帳號 / 使用其他平台 / 優化調用頻率

### 查看剩餘額度

* 登入 ModelScope → 點擊右上角 **`用戶名`** → **`API 使用情況`** ![额度查看位置](/files/59033aa990ceb9fa55e1f44f8faff51dbeafafd9)

> ⚠️ 注意：推理 API-Inference 每日 2000 次免費調用額度。更多調用需求可考慮使用阿里雲百煉等雲上服務。

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# 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/zhong-wen-fan-ti/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.