# Начало работы с Tisane

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

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

Sign up to Tisane API

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

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

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

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

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

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


**Пример** :

Запрос:


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

Ответ:


```json
{
   "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
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 (не разрешено):


```json
{
	"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.


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

* [Свяжитесь со службой поддержки](/ru/support/support), и мы посмотрим, почему это не работает для вас.
* [Советы по устранению неполадок](/ru/support/troubleshooting)


Далее:

* [Как обнаруживать проблемный контент](/ru/guides/how-tos/detectabuse)
* [Список поддерживаемых функций обработки естественного языка](/ru/guides/features/functionality)
* [Список поддерживаемых языков](/ru/guides/features/languages)