Установка

Пакет доступен на PyPI и может быть установлен через pip следующей командой:

pip install groupdocs-classification-cloud

Требования

• Python 2.7 или 3.4+

• менеджер пакетов pip

• Учётные данные GroupDocs Cloud — Client ID и Client Secret из панели управления

Зависимости

SDK автоматически устанавливает следующие пакеты:

| Пакет | Ограничение |

| — | — |

| urllib3 | >= 1.15 |

| six | >= 1.10 |

| certifi | — |

| python-dateutil | — |

Облачный REST API классификации документов для Python

Облачный SDK GroupDocs.Classification для Python — мощный REST API, разработанный для разработчиков, которым нужны расширенные возможности классификации текста и документов. Поддерживая множество форматов документов и широкий спектр таксономий, этот API позволяет классифицировать необработанный текст, документы и пакеты текстов по различным категориям, включая таксономии IAB-2, Documents и Sentiment. API защищён аутентификацией JWT, а Python SDK упрощает интеграцию в ваши веб-приложения, скрипты и автоматизированные рабочие процессы.

Возможности классификации документов

Поддержка форматов файлов — классификация текста и документов во многих форматах: PDF, DOCX, TXT.

Многоязычная поддержка — классификация документов на нескольких языках, включая английский, китайский, испанский и немецкий.

Пользовательская классификация — создание собственных категорий классификации под ваши задачи.

Пакетная классификация — классификация до 10 текстов в одном запросе.

Классификация по содержимому — классификация документов на основе их основного содержимого.

Возможности таксономической классификации

Таксономия IAB-2 — классификация по стандартной таксономии IAB-2 для цифрового контента и рекламы.

Таксономия документов — классификация документов по категориям: ADVE, Email, Form, Letter, Memo, Invoice, Report, Resume.

Таксономия тональности — классификация текста на Positive или Negative.

Таксономия Sentiment3 — классификация текста на Positive, Neutral или Negative.

Возможности интеграции API

RESTful API — доступ к классификации через REST API для простой интеграции.

Классификация в реальном времени — классификация текста и документов в реальном времени.

Ответы JSON и XML — получение результатов в JSON или XML для простой интеграции с системами.

Безопасность и аутентификация

Аутентификация JWT — безопасный доступ к API с помощью JWT.

Client ID и Secret — использование Client ID и Secret для безопасных вызовов API.

Шифрование данных — шифрование обмена данными между клиентскими приложениями и Classification Cloud API.

Производительность

Масштабируемая инфраструктура — эффективная обработка больших объёмов документов.

Высокая точность — высокоточные результаты с использованием продвинутых алгоритмов машинного обучения.

Быстрая обработка — оптимизация для быстрой классификации в высокопроизводительных приложениях.

Лицензирование и аутентификация

Режим оценки — попробуйте API с бесплатной пробной учётной записью.

Безопасная аутентификация — используйте Client ID и Client Secret для безопасного доступа к API.

Лицензия MIT — Python SDK распространяется под лицензией MIT.

Поддерживаемые форматы документов

GroupDocs.Classification Cloud поддерживает классификацию следующих форматов файлов:

| Название формата | Расширение |

| — | — |

| Portable Document Format | PDF |

| Форматы документов Words | DOC, DOCX, DOCM, DOT, DOTX, DOTM |

| Форматы Rich Text | RTF |

| Простой текстовый файл | TXT |

| Форматы OpenDocument | ODT, OTT |

Полный список форматов см. в документации.

Поддерживаемые таксономии

Таксономия IAB-2 — категории: Automotive, Books & Literature, Business & Finance, Technology & Computing, Travel и другие.

Таксономия документов — классификации: ADVE, Email, Form, Letter, Memo, News, Invoice, Report, Resume, Scientific, Other.

Таксономия тональности — бинарная классификация тональности: Negative и Positive.

Таксономия Sentiment3 — трёхклассовая тональность: Negative, Neutral, Positive.

Подробности о таксономиях см. в документации.

Быстрый старт

Получите учётные данные API

Чтобы использовать GroupDocs.Classification Cloud, зарегистрируйтесь на панели управления GroupDocs.Cloud и получите Client ID и Client Secret.

Инициализация API

Используйте следующий код для начала работы с облачным SDK GroupDocs.Classification для Python:

import groupdocsclassificationcloud

from groupdocsclassificationcloud import ClassificationApi, Configuration



# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud

client_id = "YourClientId"

client_secret = "YourClientSecret"



# Create API configuration

configuration = Configuration(client_id, client_secret, "https://api.groupdocs.cloud")



# Create instance of the Classification API

classification_api = ClassificationApi(configuration=configuration)

Классификация необработанного текста

После инициализации используйте этот базовый пример для классификации необработанного текста:

import groupdocsclassificationcloud

from groupdocsclassificationcloud import ClassificationApi, Configuration, BaseRequest, ClassifyRequest



client_id = "YourClientId"

client_secret = "YourClientSecret"



configuration = Configuration(client_id, client_secret, "https://api.groupdocs.cloud")

classification_api = ClassificationApi(configuration=configuration)



request = ClassifyRequest(BaseRequest("Try text classification"), 3)

result = classification_api.classify(request)



print("Best class name = " + result.best_class_name)

print("Best class probability = " + str(result.best_class_probability))

С этим кратким руководством вы готовы начать классифицировать текст и документы с помощью GroupDocs.Classification Cloud в ваших Python-приложениях. Подробнее см. в документации.

Получение поддерживаемых форматов файлов

Получите полный список поддерживаемых форматов файлов, доступных через Classification API.

import groupdocsclassificationcloud

from groupdocsclassificationcloud import ClassificationApi, Configuration, GetSupportedFileFormatsRequest



client_id = "YourClientId"

client_secret = "YourClientSecret"



configuration = Configuration(client_id, client_secret, "https://api.groupdocs.cloud")

classification_api = ClassificationApi(configuration=configuration)



request = GetSupportedFileFormatsRequest()

response = classification_api.get_supported_file_formats(request)



print("Supported file-formats:")

for fmt in response.formats:

    print("{0} ({1})".format(fmt.file_format, fmt.extension))

Классификация документа из облачного хранилища

Классифицируйте документ, хранящийся в облачном хранилище GroupDocs Cloud, с использованием таксономии Documents.

import groupdocsclassificationcloud

from groupdocsclassificationcloud import ClassificationApi, Configuration, BaseRequest, ClassifyRequest, FileInfo



client_id = "YourClientId"

client_secret = "YourClientSecret"



configuration = Configuration(client_id, client_secret, "https://api.groupdocs.cloud")

classification_api = ClassificationApi(configuration=configuration)



request = ClassifyRequest(

    BaseRequest(document=FileInfo(name="test_multi_pages.docx", folder="Temp/SdkTests/python"))

)

result = classification_api.classify(request)



print("Best class name = " + result.best_class_name)

print("Best class probability = " + str(result.best_class_probability))

Классификация текста с таксономией тональности

Выполните бинарный или трёхклассовый анализ тональности необработанного текста.

import groupdocsclassificationcloud

from groupdocsclassificationcloud import ClassificationApi, Configuration, BaseRequest, ClassifyRequest



client_id = "YourClientId"

client_secret = "YourClientSecret"



configuration = Configuration(client_id, client_secret, "https://api.groupdocs.cloud")

classification_api = ClassificationApi(configuration=configuration)



request = ClassifyRequest(

    BaseRequest("This product exceeded my expectations!"),

    best_classes_count=1,

    taxonomy="Sentiment3"

)

result = classification_api.classify(request)



print("Sentiment = " + result.best_class_name)

Примеры проектов на GitHub

Репозиторий облачного Python SDK GroupDocs.Classification содержит готовые к запуску модульные тесты и примеры:

| Категория | Примеры |

| — | — |

| Классификация текста | Классификация необработанного текста с таксономией IAB-2 |

| Классификация документов | Классификация документов в облачном хранилище |

| Информация | Поддерживаемые форматы файлов |

| Анализ тональности | Бинарная и трёхклассовая классификация тональности |

Как запустить примеры

1. Клонируйте или скачайте репозиторий SDK

2. Отредактируйте Settings/servercreds.json и укажите AppSid и AppKey

3. Установите зависимости: pip install groupdocs-classification-cloud -U

4. Запустите тесты из корня репозитория: python -m unittest discover -s test

Подробнее см. в разделе Начало работы.

Теги

Document Classification API | Python Cloud API | GroupDocs.Classification Cloud | REST API | Text Classification | Document Taxonomy | IAB-2 Taxonomy | Sentiment Taxonomy | Sentiment3 Taxonomy | JWT Authentication | Multi-language Support | Batch Classification | Content-Based Classification | Real-time Classification | Sentiment Analysis | Machine Learning Classification | High Accuracy Classification | Secure API Access | Cloud Storage Integration | Customer Feedback Analysis | Social Media Monitoring | Cross-platform API