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