# ModelScope (魔搭)

## Что такое ModelScope?

> ModelScope — это платформа нового поколения для совместного использования open-source-моделей по модели «модель как сервис» (MaaS), призванная предоставлять широкому кругу AI-разработчиков**гибкое, удобное и недорогое**универсальное решение для модельных сервисов, делая приложения на базе моделей проще!
>
> Через **возможности сервисизации API-Inference**платформа стандартизирует open-source-модели в вызываемые API-интерфейсы, позволяя разработчикам легко и быстро интегрировать возможности моделей в различные AI-приложения, поддерживая такие инновационные сценарии, как вызов инструментов, разработка прототипов и т. д.

### Ключевые преимущества

* ✅ **Бесплатная квота**: ежедневно предоставляется **2000 бесплатных API-вызовов**([Правила тарификации](##计费与额度规则)）
* ✅ **Обширная библиотека моделей**: охватывает более 1000 open-source-моделей в областях NLP, CV, речи, мультимодальности и др.
* ✅ **Готово к использованию**: без развёртывания, быстрый вызов через RESTful API

***

## Процесс подключения Cherry Studio

### Шаг 1: Получите токен ModelScope API

1. **Войдите на платформу**
   * Посетить [Официальный сайт ModelScope](https://modelscope.cn) → Нажмите в правом верхнем углу**Войти** → Выберите способ аутентификации ![登录界面](/files/7dfc7d05a6f52a76ba9fdf6804d370ea01a9a6db)
2. **Создайте токен доступа**

   * Перейдите в [**Настройки аккаунта → Токены доступа**](https://modelscope.cn/my/myaccesstoken)

   * нажмите **`Создать новый токен`** → Заполните описание → **Скопируйте сгенерированный токен**(*Пример страницы показан ниже*） ![新建令牌示例](/files/5ae1cdd8ebe5c4dc92bb81b47f41da344a9d42d5)

   > 🔑 **Важно**: утечка токена повлияет на безопасность аккаунта!

### Шаг 2: Настройте Cherry Studio

* Открыть **Cherry Studio** → **Настройки → Сервис моделей → ModelScope**
* В `API-ключ` вставьте скопированный токен в поле ![配置界面](/files/d6ca0ef5cb8add1e14ce04f7b3a496a5c61b0607)
* нажмите **`Сохранить`** Авторизация завершена

### Шаг 3: Вызов API модели

1. **Найдите модель с поддержкой API**

   * Посетить [Библиотека моделей ModelScope](https://modelscope.cn/models)

   * Фильтры:**Отметьте `API-Inference`**(или ориентируйтесь на значок `API` на карточке модели) ![API 模型筛选](/files/a13643262fcee38b6b261c911e86c5c58da34b1c)

   > Диапазон моделей, охватываемых API-Inference, определяется главным образом уровнем внимания к модели в сообществе ModelScope (с учётом таких данных, как лайки, загрузки и т. д.). Поэтому после выхода следующего поколения open-source-моделей с более сильными возможностями и большей популярностью список поддерживаемых моделей будет продолжать обновляться.
2. **Получите ID модели**
   * Перейдите на страницу нужной модели → скопируйте **Model ID**(формат, например `damo/nlp_structbert_sentiment-classification_chinese-base`） ![复制 Model ID](/files/fa0c4fd2a0bd4b5778bc047638034102e0c4dfbe)
3. **вставьте в Cherry Studio**
   * На странице настройки сервиса модели в поле `Model ID` введите ID → выберите тип задачи → завершите настройку ![填入模型ID](/files/0ef50fb14a1ed9079bdd2af19f511cee1f2debf8)

***

## Правила тарификации и квоты

### Важно

* 🎫 **Бесплатная квота**: каждый пользователь **ежедневно 2000 API-вызовов**(\*используйте актуальные правила с официального сайта)
* 🔁 **Сброс квоты**: ежедневно автоматически сбрасывается в 00:00 UTC+8,**не поддерживается накопление или увеличение через переход на следующий день**
* 💡 **Обработка превышения**：
  * После достижения дневного лимита API вернёт `ошибку 429`
  * Решение: переключиться на резервный аккаунт / использовать другую платформу / оптимизировать частоту вызовов

### Посмотреть оставшуюся квоту

* Войдите в ModelScope → нажмите в правом верхнем углу **`Имя пользователя`** → **`Использование API`** ![额度查看位置](/files/2b5b278d9684b682bba8bd41c0b76bb98bc5840f)

> ⚠️ Внимание: у инференс-API есть 2000 бесплатных вызовов в день. При большем объёме запросов можно рассмотреть облачные сервисы, такие как Alibaba Cloud Bailian.


---

# 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/russian/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.