# 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/e2431d2e13e19147addc482d0ba9071354eac240)
2. **アクセス トークンを作成**

   * に入る [**アカウント設定 → アクセストークン**](https://modelscope.cn/my/myaccesstoken)

   * をクリック **`新しいトークンを作成`** → 説明を入力 → **生成されたトークンをコピー**（*ページの例は下図を参照*など） ![新建令牌示例](/files/4906f4a8f6dc9367f7ba3fb7c8a1b0d16ebc481f)

   > 🔑 **重要なお知らせ**：トークンが漏洩するとアカウントの安全に影響します！

### 手順 2：Cherry Studio を設定

* 開く **Cherry Studio** を用意したフォルダ **設定 → モデルサービス → ModelScope**
* 「 `API キー` 欄にコピーしたトークンを貼り付け ![配置界面](/files/cb21f2b7b430f4c3b69981b370b18a2d90ca3f3b)
* をクリック **`保存`** 認可完了

### 手順 3：モデル API を呼び出す

1. **API 対応モデルを探す**

   * アクセス [ModelScope モデルライブラリ](https://modelscope.cn/models)

   * 絞り込み条件：**チェック `API-Inference`**（またはモデルカード上の `API` アイコンを確認） ![API 模型筛选](/files/5c21966fc56d28b271f6e758bc4d3e3a5600dbbc)

   > API-Inference がカバーするモデル範囲は、主にモデルが魔搭コミュニティでどれだけ注目されているか（いいね数、ダウンロード数などを参考）に基づいて判断されます。そのため、より高性能で注目度の高い次世代オープンソースモデルが公開された後は、対応モデルの一覧も継続的に更新されます。
2. **モデルIDを取得**
   * 対象モデルの詳細ページに入る → コピー **Model ID**（例： `damo/nlp_structbert_sentiment-classification_chinese-base`など） ![复制 Model ID](/files/0214968bd0118179e0a4e777165d942c16c77d0f)
3. **を Cherry Studio に入力**
   * モデルサービス設定ページの `モデル ID` 欄に ID を入力 → タスク種類を選択 → 設定完了 ![填入模型ID](/files/25e4512aed6469f47cc5f9dad8d6cc4e2e639546)

***

## 課金と無料枠のルール

### 重要な説明

* 🎫 **無料枠**：1ユーザーあたり **毎日 2000 回の API 呼び出し**（\*最新のルールは公式サイトに準じます）
* 🔁 **枠のリセット**：毎日 UTC+8 00:00 に自動リセット、**日をまたいだ累積や繰り越しは不可**
* 💡 **超過時の対応**に由来する：
  * 当日の上限に達すると API は `429 エラー`
  * を返します。対応策：予備アカウントに切り替える / 他のプラットフォームを使用する / 呼び出し頻度を最適化する

### 残り枠を確認

* ModelScope にログイン → 右上をクリック **`ユーザー名`** を用意したフォルダ **`API 使用状況`** ![额度查看位置](/files/837773af4b1306ffee7cb85494716123dc49166c)

> ⚠️ 注意：推論 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/jp/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.