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

Начните свое путешествие с изучения того, как быстро настроить и начать использовать API Tisane.

Шаг 1. Создайте аккаунт

Sign up to Tisane API

Бесплатный тарифный план «Сообщество» поддерживает до 50 000 запросов с ограничением в 10 запросов в минуту. (Или, если хотите, вы можете приобрести платный тарифный план).

Шаг 2. Получите свой ключ API

API Tisane использует ключи API для аутентификации запросов. Для просмотра ключей API и управления ими перейдите в свой Профиль разработчика.

Шаг 3. Используйте API

Вызовите метод POST/parse. Тело запроса метода требует три атрибута:

  • content (строка)
  • language (строка)
  • settings (объект)

Пример :

Запрос:

   {
     "language": "en", 
     "content": "Hello Tisane API", 
     "settings": {}
   }

Ответ:

{
   "text": "Hello Tisane API",
   "topics": [
   	"natural language processing",
   	"artificial intelligence"
   ],
   "entities_summary": [
   	{
   		"type": "software",
   		"name": "Tisane API",
   		"mentions": [
   			{
   				"sentence_index": 0,
   				"offset": 6,
   				"length": 10
   			}
   		]
   	}
   ]
}
В публичном облаке максимальная длина тела JSON составляет 2048 байт. Более длинные запросы доступны в локальной версии.

Вы можете протестировать свой запрос на этом портале или использовать вариант Попробовать это на Портале разработчиков. Вы также можете протестировать его с помощью curl, Postman, Insomnia или любого другого инструмента RESTful.

Синтаксис curl

curl -V -X POST \
  https://api.tisane.ai/parse \
  -H "Ocp-Apim-Subscription-Key: your_primary_or_secondary_API_key;_not_needed_on-prem" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "content": "Hello Tisane API!",
    "settings": {}
  }'

Устранение неполадок

API работает через стандартный запрос POST .

Если вы получаете ошибку тайм-аута:

  • Проверьте сетевое подключение.

Если вы получаете код ошибки 401 (не разрешено):

{
	"statusCode": 401,
	"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
  • Убедитесь, что вы указали правильный ключ API в качестве значения заголовка Ocp-Apim-Subscription-Key.

Чтобы использовать свой ключ API на этом портале документации, нажмите на кнопку _ Security_ на странице Try It.

(The Developer Portal automatically fills the API key when you sign in.)

Если вы получаете код ошибки 400 (неверный запрос), сообщающий о том, что язык не найден в базе данных:

  • Убедитесь, что вы указываете правильный код языка ISO-639-1 и что этот язык поддерживается Tisane.

Если вам нужна дополнительная помощь:

Далее:

 

Guides