# 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 次免費調用額度。更多調用需求可考慮使用阿里雲百煉等雲上服務。


---

# Agent Instructions: 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:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/pre-basic/providers/modelscope.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.