# 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) → 撳右上角**登入** → 選擇認證方式 ![登录界面](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-914b9cc6f8da04291beb8fc7c47f94b1698e50e8%2Fimage.png?alt=media)
2. **建立存取令牌**

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

   * 撳 **`新增令牌`** → 填寫描述 → **複製生成嘅令牌**（*頁面示例見下圖*） ![新建令牌示例](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-087b472a2b37b3aa64c84094675555bbde27268b%2Fimage-7.png?alt=media)

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

### 步驟 2：設定 Cherry Studio

* 打開 **Cherry Studio** → **設定 → 模型服務 → ModelScope**
* 喺 `API 密鑰` 欄貼上複製嘅令牌 ![配置界面](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-f29ddc9a3fbe222901f4aa894fa07304f381c161%2Fimage-2.png?alt=media)
* 撳 **`儲存`** 完成授權

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

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

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

   * 篩選條件：**勾選 `API-Inference`**（或者認準模型卡片上嘅 `API` 圖示） ![API 模型筛选](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-ebb4985516d5eb1c680b6acdcd483af6e9b6bb6a%2Fimage-3.png?alt=media)

   > API-Inference 覆蓋嘅模型範圍，主要係根據模型喺魔搭社區入面嘅關注程度（參考咗點讚、下載等數據）嚟判斷。所以，當能力更強、關注度更高嘅下一代開源模型發布之後，支援嘅模型清單都會持續迭代。
2. **獲取模型 ID**
   * 入去目標模型詳情頁 → 複製 **Model ID**（格式例如 `damo/nlp_structbert_sentiment-classification_chinese-base`） ![复制 Model ID](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-7d5c8ef3b6469b38ce99280af3d92e007ce6cab4%2Fimage-5.png?alt=media)
3. **填入 Cherry Studio**
   * 喺模型服務設定頁嘅 `模型 ID` 欄輸入 ID → 選擇任務類型 → 完成設定 ![填入模型ID](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-c0ac835ecb5d6ae1723e59573e5d2c923ec52a65%2Fimage-6.png?alt=media)

***

## 收費同額度規則

### 重要說明

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

### 查看剩餘額度

* 登入 ModelScope → 撳右上角 **`用戶名`** → **`API 使用情況`** ![额度查看位置](https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2babab6f9646eac2f47fd895a5a074fa12db66e7%2Fimage-8.png?alt=media)

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