Перейти к основному содержимому

Caila REST API

Caila REST API — это то API, через которое работает веб-интерфейс Caila. Все функции, существующие в веб-интерфейсе, доступны через REST API.

Доступна Swagger спецификация — https://caila.io/swagger-ui

Для Python и Java доступны сгенерированные клиенты. Они находятся здесь: Python SDK и Java SDK.

Для доступа к API потребуется создать API-токен, сделать это можно в соответствующем разделе веб-интерфейса. Если вы используете API для создания композитного сервиса, то токен будет передан в сервис через переменную окружения MLP_CLIENT_TOKEN (подробнее см. раздел Композитные сервисы), а адрес сервера через переменную MLP_REST_URL.

Возможности REST API

  • Обращение к Caila-сервисам: Predict API
  • Создание производных сервисов и запуск обучения
  • Загрузка и управление датасетами
  • Создание и настройка сервисов
  • Подключение выделенных серверов и управление пулами ресурсов
  • Получение информации о балансе, затратах и доходах
  • И многое другое.

Пример вызова

Рассмотрим пример обращения к сервису vectorizer-caila-roberta.

curl -X POST https://caila.io/api/mlpgate/account/just-ai/model/vectorizer-caila-roberta/predict \
-H "MLP-API-KEY: xxx" \
-H "Content-Type: application/json" \
-d '{"texts":["Привет"]}'

Ожидаемый ответ:

{"embedded_texts":[{"vector":[0.4766579270362854,-0.18601498007774353,0.23763521015644073,-0.5908674597740173,-0.22597207129001617,-0.13075418770313263,0.2103278487920761,-0.6492880582809448,-0.4092460870742798,-0.5639411211013794,0.12688767910003662,0.37768375873565674,0.3678416311740875,0.35923194885253906,0.005947093013674021]}]}