> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/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)

***

## 課金と利用枠のルール

### 重要事項

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

### 残り利用枠を確認

* ModelScope にログイン → 右上の **`ユーザー名`** をクリック → **`API 利用状況`** ![额度查看位置](/files/837773af4b1306ffee7cb85494716123dc49166c)

> ⚠️ 注意：推論 API-Inference の無料呼び出し枠は 1 日 2000 回です。さらに多くの呼び出しが必要な場合は、阿里云百炼などのクラウドサービスの利用をご検討ください。

***

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

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/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.cherry-ai.com/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.