> 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/jp/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/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 の1日2000回の無料呼び出し枠があります。より多くの呼び出しが必要な場合は、阿里云百炼などのクラウドサービスの利用をご検討ください。

***

### ヘルプの取得とフィードバックの送信

設定または使用中に不明点、バグ、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/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/jp/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.