Основы работы с API

Привет Гость, для начала работ вам нужно зарегистрироваться или войти в свой личный кабинет в Web-редакторе
Войти или зарегистрироваться

Все запросы отправляются на урл https://www.turbotext.ru/api_ai

 

Тарифы

Для возможности использовать API для генераций фото, текста, анализа и других методов,

API доступен только для подписчиков на тариф VIP


Купить PRO + Доступ к API

После покупки тарифа вам будет доступен Turbotext API  и Web-редактор

Авторизация

Идентификацию пользователя организуйте посредством Bearer Token,

Пример CURL, данные с Headers запроса

Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded

Доступные методы

Запрос на создании очереди
/api_ai/available_api HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/available_api HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"available_api": [
{'name': 'clickbait', 'description': "Проверка на кликбейт", 'url': '/predict'},
{'name': 'boring_title', 'description': "Проверка на скучности заголовка", 'url': '/boring_title'},
...
{'name': 'generate_title', 'description': "Генерация заголовка по тексту", 'url': '/generate_title'}
]
}
}

Webhook

Если вы хотите запустить серию генераций вам необходимо использовать асинхронный метод генерации, для этого создаем webhook который сможет принимать и обрабатывать результаты генераций.

При обычном методе генерации, вы создаете очередь, затем с помощью номера очереди получаете результат генерации,

в асинхронном методе геннерации, вы создаете очередь добавив в пост данные

webhook=https://mysite.com/webhook_example.php

Ответ на запрос будет такой

{"success":true,"asyncid":N}

где N номер очереди, при получении ответа вы получите параметр asyncid с таким же значением

Нейро-сервер после обработки вашего запроса, отправит вам на адрес который вы указали в параметре webhook POST данные с результатом генерации,

Формат данных точно такой же как и при получении вторым запросом.

Вы получите результат генерации на ваш WEBHOOK URL в формате JSON

пример получения результата на php

$result=file_get_contents('php://input');//входящий JSON результат

$result_array=json_decode($result,1);//Результаты в массиве

Фото - методы

Генерация изображений v1

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-15 секунд (при разрешении 768х768, num_images=1 и отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **steps** - кол-во шагов, сколько нейросеть будет проходить по квадрату 8х8 пикселей. Чем больше значение, тем меньше шумов, но дольше генерация.

    **seed** - идентификатор изображения. По умолчанию случайное значение, если указывать одинаковый seed, то можно воссоздать изображение.

    **negative_prompt** - перечисление элементов на изображении, которые надо удалить. Например: автомобиль, дом. Перечислять через запятую.

    **scale** - степень фантазии, насколько результат должен соответствовать запросу (рекомендуется использовать от 7 до 12)

    **category** - стиль изображения (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)

    **version_model** - версия модели (v1)

    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_text2image_id<user_id>_<numder_image>.png

Запрос на создании очереди
/api_ai/generate_text2image_model_v1 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required ` # prompt for text2image`
user_id: string ` # default: 1`
width: int ` # min: 8, max: 1024, default: 768`
height: int ` # min: 8, max: 1024, default: 768`
seed: int `# min: 1, max: 10**10, default: random`
steps: int `# min: 1, max: 100 for 768x768 and 55 for 1024x1024, default: 55`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`
num_images: int `# max: 3, default: 1`
category: string `# one of the style (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)`
version_model: string `# v1; default: v3`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2image_model_v1 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 5,
"image": [
"image/generate_text2image_id5_0.png",
"image/generate_text2image_id5_1.png"
],
"style_image": "cartoon",
"prompt": "Мультяшный роботизированный милый белый медведь профессор сидит в классе и читает книгу",
"width": 768,
"height": 768,
"steps": 40,
"scale": 7.0,
"seed": 7365514174,
"num_images": 2,
"original_language": "ru"
}
}

Генерация изображений v2

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-15 секунд (при разрешении 768х768, num_images=1 и отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **steps** - кол-во шагов, сколько нейросеть будет проходить по квадрату 8х8 пикселей. Чем больше значение, тем меньше шумов, но дольше генерация.

    **seed** - идентификатор изображения. По умолчанию случайное значение, если указывать одинаковый seed, то можно воссоздать изображение.

    **negative_prompt** - перечисление элементов на изображении, которые надо удалить. Например: автомобиль, дом. Перечислять через запятую.

    **scale** - степень фантазии, насколько результат должен соответствовать запросу (рекомендуется использовать от 7 до 12)

    **category** - стиль изображения (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)

    **version_model** - версия модели (v2 - для кинематографических)

    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_text2image_id<user_id>_<numder_image>.png

Запрос на создании очереди
/api_ai/generate_text2image_model_v2 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required ` # prompt for text2image`
user_id: string ` # default: 1`
width: int ` # min: 8, max: 1024, default: 768`
height: int ` # min: 8, max: 1024, default: 768`
seed: int `# min: 1, max: 10**10, default: random`
steps: int `# min: 1, max: 100 for 768x768 and 55 for 1024x1024, default: 55`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`
num_images: int `# max: 3, default: 1`
category: string `# one of the style (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)`
version_model: string `# v2; default: v2`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2image_model_v2 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 5,
"image": [
"image/generate_text2image_id5_0.png",
"image/generate_text2image_id5_1.png"
],
"style_image": "cartoon",
"prompt": "Мультяшный роботизированный милый белый медведь профессор сидит в классе и читает книгу",
"width": 768,
"height": 768,
"steps": 40,
"scale": 7.0,
"seed": 7365514174,
"num_images": 2,
"original_language": "ru"
}
}

Генерация изображений v3

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-15 секунд (при разрешении 768х768, num_images=1 и отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **steps** - кол-во шагов, сколько нейросеть будет проходить по квадрату 8х8 пикселей. Чем больше значение, тем меньше шумов, но дольше генерация.

    **seed** - идентификатор изображения. По умолчанию случайное значение, если указывать одинаковый seed, то можно воссоздать изображение.

    **negative_prompt** - перечисление элементов на изображении, которые надо удалить. Например: автомобиль, дом. Перечислять через запятую.

    **scale** - степень фантазии, насколько результат должен соответствовать запросу (рекомендуется использовать от 7 до 12)

    **category** - стиль изображения (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)

    **version_model** - версия модели (v3 - для фотореализма)

    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_text2image_id<user_id>_<numder_image>.png

Запрос на создании очереди
/api_ai/generate_text2image_model_v3 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required ` # prompt for text2image`
user_id: string ` # default: 1`
width: int ` # min: 8, max: 1024, default: 768`
height: int ` # min: 8, max: 1024, default: 768`
seed: int `# min: 1, max: 10**10, default: random`
steps: int `# min: 1, max: 100 for 768x768 and 55 for 1024x1024, default: 55`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`
num_images: int `# max: 3, default: 1`
category: string `# one of the style (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)`
version_model: string `# v3; default: v3`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2image_model_v3 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 5,
"image": [
"image/generate_text2image_id5_0.png",
"image/generate_text2image_id5_1.png"
],
"style_image": "cartoon",
"prompt": "Мультяшный роботизированный милый белый медведь профессор сидит в классе и читает книгу",
"width": 768,
"height": 768,
"steps": 40,
"scale": 7.0,
"seed": 7365514174,
"num_images": 2,
"original_language": "ru"
}
}

Генерация изображений v4

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-15 секунд (при разрешении 768х768, num_images=1 и отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **steps** - кол-во шагов, сколько нейросеть будет проходить по квадрату 8х8 пикселей. Чем больше значение, тем меньше шумов, но дольше генерация.

    **seed** - идентификатор изображения. По умолчанию случайное значение, если указывать одинаковый seed, то можно воссоздать изображение.

    **negative_prompt** - перечисление элементов на изображении, которые надо удалить. Например: автомобиль, дом. Перечислять через запятую.

    **scale** - степень фантазии, насколько результат должен соответствовать запросу (рекомендуется использовать от 7 до 12)

    **category** - стиль изображения (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)

    **version_model** - версия модели (v4)

    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_text2image_id<user_id>_<numder_image>.png

Запрос на создании очереди
/api_ai/generate_text2image_model_v4 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required ` # prompt for text2image`
user_id: string ` # default: 1`
width: int ` # min: 8, max: 1024, default: 768`
height: int ` # min: 8, max: 1024, default: 768`
seed: int `# min: 1, max: 10**10, default: random`
steps: int `# min: 1, max: 100 for 768x768 and 55 for 1024x1024, default: 55`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`
num_images: int `# max: 3, default: 1`
category: string `# one of the style (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)`
version_model: string `# v4; default: v4`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2image_model_v4 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 5,
"image": [
"image/generate_text2image_id5_0.png",
"image/generate_text2image_id5_1.png"
],
"style_image": "cartoon",
"prompt": "Мультяшный роботизированный милый белый медведь профессор сидит в классе и читает книгу",
"width": 768,
"height": 768,
"steps": 40,
"scale": 7.0,
"seed": 7365514174,
"num_images": 2,
"original_language": "ru"
}
}

Генерация изображений v5

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-15 секунд (при разрешении 768х768, num_images=1 и отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **steps** - кол-во шагов, сколько нейросеть будет проходить по квадрату 8х8 пикселей. Чем больше значение, тем меньше шумов, но дольше генерация.

    **seed** - идентификатор изображения. По умолчанию случайное значение, если указывать одинаковый seed, то можно воссоздать изображение.

    **negative_prompt** - перечисление элементов на изображении, которые надо удалить. Например: автомобиль, дом. Перечислять через запятую.

    **scale** - степень фантазии, насколько результат должен соответствовать запросу (рекомендуется использовать от 7 до 12)

    **category** - стиль изображения (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)

    **version_model** - версия модели (v5)

    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_text2image_id<user_id>_<numder_image>.png

Запрос на создании очереди
/api_ai/generate_text2image_model_v5 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required ` # prompt for text2image`
user_id: string ` # default: 1`
width: int ` # min: 8, max: 1024, default: 768`
height: int ` # min: 8, max: 1024, default: 768`
seed: int `# min: 1, max: 10**10, default: random`
steps: int `# min: 1, max: 100 for 768x768 and 55 for 1024x1024, default: 55`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`
num_images: int `# max: 3, default: 1`
category: string `# one of the style (realism, cartoon, anime, cinematic, cyberpunk, steampunk, portrait, dark)`
version_model: string `# v5; default: v5`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2image_model_v5 HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 5,
"image": [
"image/generate_text2image_id5_0.png",
"image/generate_text2image_id5_1.png"
],
"style_image": "cartoon",
"prompt": "Мультяшный роботизированный милый белый медведь профессор сидит в классе и читает книгу",
"width": 768,
"height": 768,
"steps": 40,
"scale": 7.0,
"seed": 7365514174,
"num_images": 2,
"original_language": "ru"
}
}

Генерация запросов

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: 0.5-3 секунды (при отсутствии очередей)
  * Длина запроса: от 1 до 80 токенов/слов (обрезается автоматически лишнее).
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_prompts HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
original_language: string `# default: ru`
content: string - required `# min: 1 word, max: 80 words`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_prompts HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
"1980s vintage autochrome photo of a giant huge futuristic steampunk airship in the middle with an alien spaceship inside, and people walking around by james gurney, featured on cg society, retrofuturism, matte painting, reimagined by industrial light and magic, vray tracing, 8k render, octane",
"1980s vintage autochrome photo of a woman on fire in the middle of a forest, night time, film grain, depth of field. bokeh. golden hour. cinematic. realistic. light fixtures. detailed. hq. realistic. warm light. muted colors. filmic. dreamy. lens flare.",
"1980s vintage autochrome photo of a man in his mid-length hair, looking at the camera with an iphone by the window. he is wearing a black suit and necktie while holding a large hamburger. his eyes are closed and he has sharp teeth. it's staring at the camera, and there are no lights behind him"
]
}

Увеличение изображения

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 10-60 секунд (при отсутствии очередей, зависит от размера изображения на входе)
  * _Примечания_:

    * Увеличивает изображение в 4 раза. Максимальное разрешение: 4096х4096

    * **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    * Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/upscale_image_<user_id>.png

Запрос на создании очереди
/api_ai/upscale_image HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
user_id: int - required `# default: 1`
content: string - required `# url with image (format: jpg, png, jpeg)`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/upscale_image HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "image/upscale_image_.png"
}

Обработка фото

Списания по тарифу

При генерации списываются Фото попытки

* Время выполнения запроса: 15-30 секунд (при отсутствии очередей, зависит от размера изображения на входе)
  * _Примечания_:

    **original_language** - язык, на котором написан запрос, перевод будет происходить на английский внутри API, если язык оригинала не английский.
    Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

    **strength** - степень изменения изображения. От 0 до 80, где 0 - меньше всего изменений, а 80 - больше всего. По умолчанию 40.

    Преобразованное изображение меняет своё разрешение в пропорции к 768 пикселей по большей стороне (максимальное разрешение: 768х768)

  *
    Чтобы загрузить изображение с сервера, необходимо сделать GET-запрос к значению из ключа image в теле ответа.
    Ссылка для запроса имеет вид:
    /image/generate_image2image_<user_id>_<number_image>.png

Запрос на создании очереди
/api_ai/generate_image2image HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
user_id: int `# default: 1`
url: string - required `# url with image (format: jpg, png, jpeg)`
content: string - required ` # prompt for image2image`
strength: int ` # degree of image change, 0 to 80, default: 40`
seed: int `# min: 1, max: 10**10, default: random`
scale: float `# min: 0.1, max: 20, default: 7.5`
negative_prompt: string `# what to remove on image (max: 80 words), default: bad anatomy params`
original_language: string `# default: ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_image2image HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"user_id": 12,
"image": [
"image/generate_image2image_id12_0.png"
],
"prompt": "девушка в костюме супермена",
"width": 768,
"height": 768,
"scale": 7.5,
"seed": 5443937701,
"strength": 50,
"original_language": "ru"
}
}

Удалить фон изображения

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/remove_background HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
url - string required, урл на фото которое нужно обработать

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/remove_background HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{"success":true,"error":"","data":[],"uploaded_image":"https://www.turbotext.ru/download.php?f=..........png","limits":{"foto_limit":123,"text_limit":123,"vseznayka_limit":123,"video_limit":123}}

Метод Микс-фото

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/mix_images HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content - описание для усиления эффекта
url_image_target - фото на урл которое нужно обработать
url - фото на урл откуда используем стиль

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/mix_images HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{"success":true,"error":"","data":{"prompt":"В стиле дисней"],"width":768,"height":576,"seed":9147962925,"strength":50,"pattern_prompt":false},"uploaded_image":"https://www.turbotext.ru/download.php?f=..........png"}

Замена объекта

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/generate_inpainting HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
url - урл на фото которое нужно обработать
mask_image - урл на маску которую используем для замены объекта
content - описание объекта для замены
strength_image
seed
negative_prompt
original_language
face_restore

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_inpainting HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success":true,"error":"",
"data":Входные параметры,
"uploaded_image":"Прямая ссылка на файл с результатом"
}

Создать маску для замены объекта

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/generate_image_mask HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
url - урл на фото для обработки
content - описание объекта для выборки
inversion_mask - true/false(если выберать нужно все кроме объекта)
face_restore - true/false(если нужно улучшить фото)

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_image_mask HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{"success":true,"error":"","data":{"prompt":"Очки","prompt_en":"bra","inversion_mask":false},"uploaded_image":"https://www.turbotext.ru/download.php?f=..........png"}

Улучшить фото

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/restore_face HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
url - string required, урл на фото которое нужно улучшить

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/restore_face HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{"success":true,"error":"","data":[],"uploaded_image":"https:\/\/www.turbotext.ru\/download.php?f=..........png","limits":{"foto_limit":123,"text_limit":123,"vseznayka_limit":123,"video_limit":123}}

Замена лица

Списания по тарифу

При генерации списываются Фото попытки

Запрос на создании очереди
/api_ai/deepfake_photo HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
url - урл с фото человека кому будем менять лицо
url_image_target - урл с лицом на которое нужно заменить
face_restore - True/False

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/deepfake_photo HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success":true,
"error":"",
"data":{"image":["https://...png"],
"width":980,"height":1472,"forbidden_content":false,"face_restore":"False"},
"uploaded_image":"Ссылка на фото с результатом генерации"
}

Текстовые методы

Рерайта текста

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: ~4 секунд на 1000 символов.
  * Ограничения по длине текста в запросе: от 1 до 1050 слов.
  * Длина текста после генерации: не более чем на 25% длиннее текста в запросе.
  * Timeout (sec): 300
  * _Примечание_:

    **conversion_level** - степень преобразования рерайта нейросети. Значение целочисленное от 0 до 10, где 0 - меньше всего изменений, а 10 - больше всего

  * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_rewrite_text_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required
conversion_level: int - required ` # default: 5`
original_language: string - required `# default: ru`
translated_language: string - required `# default ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_rewrite_text_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "data": {
"input_text": "Алкоголь подавляет функции человеческого мозга и влияет на поведение, но мало известно о неврологических процессах, которые контролируют это. Ранее ученые считали, что в «пьяном поведении» виноваты реакции в печени, вероятность того, что на это влияли процессы в мозге, долгое время не находила подтверждения. Новое исследование, проведенное учеными из Национального института по борьбе с алкоголизмом, США, на образцах человеческого мозга и на мышах, смогло доказать это. Поведенческие эффекты алкоголя (неуклюжесть, заторможенность, неразборчивость речи) вызываются метаболитами, которые образуются в процессе расщепления организмом пива, вина и других спиртных напитков. Один из них, ацетат, вырабатывается ферментом под названием ALDH2, который в изобилии содержится в печени, но новые тесты показывают, что он также находится в мозге. В частности, в астроцитах в мозжечке, области мозга, которая контролирует баланс и координацию. В рамках эксперимента ученые удалили ALDH2 из клеток мышей, это сделало лабораторных грызунов невосприимчивыми к двигательным нарушениям, вызванными употреблением алкоголя. Они показывали отличные результаты на вращающемся цилиндре, который проверяет навыки равновесия и координации. Авторы работы также обнаружили, что употребление алкоголя активирует нейромедиатор GABA, который успокаивает нервы и вызывает сонливость. Вот почему мы невнятно произносим слова, плохо обрабатываем внешнюю информацию, «тормозим» и становимся неуклюжими, когда пьяны. Результаты нового исследования могут привести к улучшению методов лечения алкоголизма и пьянства, а также других состояний, которые снижают баланс и координацию, включая инсульт, болезнь Паркинсона и рассеянный склероз.",
"results": [
"Ученые из Национального института по борьбе с алкоголизмом, США, смогли доказать, что в «пьяном поведении» виноваты реакции в мозге и влияют на поведение, но мало известно о неврологических процессах, которые контролируют это. Ранее ученые считали, что алкоголь подавляет функции человеческого мозга и влияет на поведение. Об этом сообщает РИА Новости со ссылкой на исследование, проведенное в рамках эксперимента на образцах мозга и на мышах. Они удалили ацетат из клеток мышей, что сделало лабораторных грызунов невосприимчивыми к двигательным нарушениям, вызванным употреблением пива, вина и других спиртных напитков. В рамках эксперимента ученые удалили ALDH2 из клеток мыши, которая контролирует баланс и координацию. Эти результаты показали отличные результаты на вращающемся цилиндре, который проверяет навыки равновесия и координации. Авторы работы также обнаружили, что употребление алкоголя активирует нейромедиатор GABA, который успокаивает нервы и вызывает сонливость. Вот почему мы невнятно произносим слова, плохо обрабатываем внешнюю информацию, «тормозим» и становимся неуклюжими, когда пьяны. Результаты нового исследования могут привести к улучшению методов лечения алкоголизма и пьянства, включая инсульт, болезнь Паркинсона и рассеянный склероз.",
"Ученые из США на образцах человеческого мозга и мышей смогли доказать, что в «пьяном поведении» виноваты реакции в печени. Об этом сообщает РИА Новости со ссылкой на Национальный институт по борьбе с алкоголем. В результате эксперимента ученые удалили ALDH2 из клеток мышей. Это сделало лабораторных грызунов невосприимчивыми к двигательным нарушениям, вызванным употреблением алкоголя. Полученные результаты показали отличные результаты на вращающемся цилиндре, который проверяет навыки равновесия и координации. Учеными удалось доказать это, используя ацетат, которого в изобилии содержится в крови. Однако новые тесты показывают, что он также находится в мозге. В частности, в астроцитах в мозжечке, области мозга, которая контролирует баланс и координаты. Для того, чтобы улучшить работу мозга в лечении алкоголизма, можно использовать его как альтернативу. Также исследователи обнаружили, что употребление алкоголя активирует нейромедиатор GABA, которой успокаивает нервы и вызывает сонливость. Вот почему мы невнятно произносим слова, плохо обрабатываем внешнюю информацию, «тормозим» и становимся неуклюжими, когда пьяны."
]
}
}

Описание к товару по тексту

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: 2-15 секунд.
  * Минимальное суммарное (для всех значений в теле запроса) кол-во слов для генерации: 30  
  * Примечания:

  1. brand - название бренда/компании производителя (например: ЛялинаМода);
  2. product_category - категория товара (например: Конверт на выписку новорожденного);
  3. product_parameters - параметры товара, его характеристики и назначение, перечисляются через точку с запятой (;), а между наименованием категории и значением ставится тире _**(например: Вид застежки - Пуговица, петля; Фактура материала - барашек; Декоративные элементы - бант; Утеплитель - холстон; Материал подкладки - хлопок; Назначение - на выписку; в роддом; в коляску; повседневная; на прогулку; Высота предмета - 65 см; Ширина предмета - 35 см; Вид конверта - конверт-одеяло; комплект; конверт на выписку; Особенности конверта - конверт на выписку лето; конверт на выписку зимний; конверт на выписку демисезон; Направление - на выписку в подарок, для дома, отдыха, сна; на выписку для новорожденного; Страна производства - Россия; Комплектация - чехол; ползунки; Шапочка; одеяло; кофточка; распашонка; бант; Пол - Детский)**_
  4. Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_description_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
brand: string - required
product_category: string - required
product_parameters: string - required
original_language: string - required `# default: ru`
translated_language: string - required `# default ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_description_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
"Тушь для ресниц Maybeline Maybelon позволяет легко прокрашивать реснички без комочков. Не требует использования специальных средств для снятия туши, она легко смывается и не оставляет комков. Благодаря своей эластичной текстуре тушь идеально прокрашивает даже самые короткие ресницы. Ресницы выглядят естественно, при этом удлиненные и длинные. В составе туши нет парабенов, которые могут вызвать аллергию, т.к. пигмент имеет свойство вымываться в течение дня.",
"Тушь для ресниц Maybeline, это новый профессиональный продукт от компании Maybelon. Уникальная формула туши, не содержит клей и подходит для чувствительных глаз. С ней вы получите идеальный результат на весь день! Красивая тушь с натуральной текстурой легко распределяется по всей длине ресниц, придавая им естественный и выразительный вид. Цвет: темно-коричневый. Способ применения: Нанесите тушь по направлению роста ресниц. При необходимости повторите процедуру.",
"Тушь для ресниц, разработанная специально для тех, кто хочет подчеркнуть свой взгляд и подчеркнуть красоту своих глаз. Она не утяжеляет и не склеивает ресницы, что позволяет сделать макияж более выразительным. Красивая текстура туши прекрасно ложиться на ресницы. В составе только натуральные компоненты, которые гарантируют качество. Стойкость до 8 часов. Не отпечатывается. С ней любой макияж будет выглядеть естественно и выразительно. Тушь быстро высыхает и не размазывается."
]
}

Генерация отзывов к товару по тексту

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 7-30 секунд.
  * Минимальное кол-во слов на входе для генерации: 30
  * Примечания:
    1. brand - название бренда/компании производителя (например: ЛялинаМода);
    2. product_category - категория товара (например: Конверт на выписку новорожденного);
    3. product_parameters - параметры товара, его характеристики и назначение, перечисляются через точку с запятой (;), а между наименованием категории и значением ставится тире _**(например: Вид застежки - Пуговица, петля; Фактура материала - барашек; Декоративные элементы - бант; Утеплитель - холстон; Материал подкладки - хлопок; Назначение - на выписку; в роддом; в коляску; повседневная; на прогулку; Высота предмета - 65 см; Ширина предмета - 35 см; Вид конверта - конверт-одеяло; комплект; конверт на выписку; Особенности конверта - конверт на выписку лето; конверт на выписку зимний; конверт на выписку демисезон; Направление - на выписку в подарок, для дома, отдыха, сна; на выписку для новорожденного; Страна производства - Россия; Комплектация - чехол; ползунки; Шапочка; одеяло; кофточка; распашонка; бант; Пол - Детский)**_
    4. Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_review_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
brand: string - required
product_category: string - required
product_parameters: string - required
original_language: string - required `# default: ru`
translated_language: string - required `# default ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_review_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
"Заказывала 2 комплекта на выписку! Оба очень красивые, и тёплые и удобные! Не смотря на то что не было отзывов, я рискнула купить и не пожалела! Всё подошло идеально! Размер брала 80-86 (ребёнок 77см). В итоге комплект получился чуть больше чем мы ожидали, но это даже хорошо!!! Спасибо большое за такие прекрасные вещи",
"Шикарный комплект! Мягкий и теплый (это хорошо, тк сейчас все дети мёрзнут), но и очень удобный, так как можно разложить по фигуре малыша, не боясь за его ушибистость)) Очень порадовал размер комплекта, думаю ещё зимой сможем носить. Спасибо производителю!",
"Отличный набор. Приятный цвет, хорошо упаковано. Есть небольшой запах, но не критично. На рост 63 см и вес 11 кг взяла 68 размер, чтобы был запас на вырост. Как раз на конец весны и начало лета точно хватит."
]
}

Генерация отзывов и описаний к товару по фото

* Время: 2-10 секунд
  * Поддерживаемые форматы: jpg, jpeg, png, webp
  * Доступные разрешения изображений: от 64х64 до 7680х4320 (чем больше, тем дольше обрабатывает)
  * Максимальный размер: 20 Мб
  * Средняя длина генерируемых отзывов: 385 символов
  * Средняя длина генерируемых описаний: 510 символов
  * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Генерация заголовка по тексту

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: 1-3 секунды
  * Длина заголовков: 85 символов (в среднем), 130 символов (максимум)

Запрос на создании очереди
/api_ai/generate_title_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_title_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{"success":true,"error":"","data":"Мечта — это реальность: Психолог рассказал, как мечты помогают понять характер человека"}

Генерация короткого заголовка

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: 1-3 секунды
  * Длина заголовков: 70 символов (в среднем), 140 символов (максимум)
  * _Примечание_: **num_titles** - количество заголовков, которые должна сгенерировать модель. Значение целочисленное от 1 до 5 (по умолчанию: 1)

Запрос на создании очереди
/api_ai/generate_short_title_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required
num_titles: int - required ` # max: 5`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_short_title_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Харламов избавился от Асмус ради новой любовницы"
}

Генерация рерайта по предложениям

Списания по тарифу

При генерации списываются текстовые попытки

* Время: ~2-3 сек./30 слов с разбивкой
  * Минимальное количество слов в тексте: 30, максимальное - 1050
  * по user_id получаем сгенерированный текст
  * current_text в response - текущее завершенное предложение
  * number_of_texts в response - общее количество предложений

Запрос на создании очереди
/api_ai/generate_paraphraser_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required (если user_id не передаётся)
user_id: string - required (если content не передаётся)

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_paraphraser_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
```
responce (если передавать user_id):
"success": true,
"error": "",
"data": {
"input_text": "Власти РФ приняли новые меры, чтобы сохранить текущий уровень цен на бензин и остальное топливо. Глава отечественного правительства Михаил Мишустин подписал меняющий порядок биржевых торгов горючим указ. Ведущие нефтяные корпорации прежде обязывались передать часть выработанного топлива на биржу с последующей продажей по рыночной стоимости.",
"results": [
{
"origin_sentence": "Власти РФ приняли новые меры, чтобы сохранить текущий уровень цен на бензин и остальное топливо.",
"predictions": [
"Российские власти приняли новые меры, чтобы сохранить текущий уровень цен на топливо.",
"Власти России приняли новые меры, чтобы сохранить текущий уровень цен на бензин и остальное топливо.",
"Путин подписал указ об улучшении темпов повышении цен на топливо, бензин и другие виды нефтепродуктов.",
"Власти России приняли новые меры, чтобы сохранить текущий уровень цен на топливо."
]
},
...
{
"origin_sentence": "Ведущие нефтяные корпорации прежде обязывались передать часть выработанного топлива на биржу с последующей продажей по рыночной стоимости.",
"predictions": [
"Ведущие нефтяные корпорации прежде обязывались передать на биржу часть выработанного топлива с последующей продажей по рыночной стоимости.",
"Ведущие нефтяные корпорации раньше обязывались передать выработанный топлива на биржу с последующей продажей по рыночной стоимости.",
"Ведущие нефтяные компании раньше обязывались передать часть выработанного топлива на биржу с последующей продажей по рыночной стоимости.",
""Нефтяные корпорации" прежде обязывались передать выработанный топлива на биржу с последующей продажей по рыночной стоимости.",
"Глава нефтяных корпораций впервые обязался передать на биржу часть выработанного топлива с последующей продажей по рыночной стоимости."
]
}
],
"current_text": 3,
"number_of_texts": 3
}
```
responce (если передавать content):
"success": true,
"error": "",
"data": {
"user_id": "75704958e78dbf22df029067245a79ce"
}
```

Генерация текста по ключевикам и описанию

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 5-10 секунд
  * Рекомендуемое кол-во символов на входе (заголовок+описание+ключевики): не менее 250 (в среднем 300-500)
  * Кол-во символов (с учётом пробелов) на выходе после генерации: от 400 до 5000 (в среднем 900-1300)
  * Три входных параметра для генерации: заголовок (title), краткое описание статьи (description_article), ключевые слова (keys_of_article)
  * Все группы ключевиков (даты, локации и т.п.) помещаются в одну строку и перечисляются через запятую. Пример: "Путин, Москва, Всемирная организация здравоохранения, 9 мая".
  * Результат подачи на вход (Слова "Заголовок", "Описание" и "Ключевики" прописывать не надо, всё разделено в API): "Заголовок: ATA Corporation выпустила универсальную проверку текстов TurboCheck; Описание: Сервис TurboCheck предназначен для блогеров, авторов информационных текстов и SEO-экспертов. С помощью искусственного интеллекта в сервисе осуществляются проверки на: привлекательность заголовка, позитивность, дочитываемость и кликбейтность текста, а современные алгоритмы помогают найти проблемы; Ключевики: TurboCheck, ATA Corporation, проверка текста, искусственный интеллект, «Покатим.Ру»"
  * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_text_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
description_article: string - required
keys_of_article: string - required
original_language: string - required `# default: ru`
translated_language: string - required `# default ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text_ru HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Компания ATA Corporation выпустила универсальную проверку текстов TurboCheck. Об этом сообщается в пресс-релизе, поступившем в редакцию «Покатим.Ру». В тестировании принимают участие блогеры, авторы информационных текстов и специалисты по продвижению сайтов. Для проверки текста используется алгоритм машинного обучения, который анализирует текст с точки зрения его уникальности, читаемости и привлекательности. При этом алгоритм учитывает не только текстовую составляющую, но и графические элементы, такие как изображения, видео, аудио, ссылки и другие элементы. По словам разработчиков, система способна выявлять ошибки в тексте, которые могут быть связаны с неправильным оформлением или стилистикой. Кроме того, она может выявить ошибки в орфографии и пунктуации. Тестирование проходит в несколько этапов. На первом этапе проверяется уникальность заголовка, оптимизированный текст, дочитываемость и кликбейтность текста. После этого проверяются ключевые слова, метаданные, плотность ключевых слов, а также их количество. На втором этапе проверяется качество текста, его соответствие требованиям поисковых систем. На третьем этапе проверяется уникальность изображений, видео, аудио, ссылок и других элементов. В конце теста проверяется правильность оформления текста. Ранее стало известно, что сервис TurboCheck стал доступен для пользователей Android. Он позволяет проверять тексты на наличие ошибок, а также исправлять их"
}

Генерации видео

Генерация музыки

Генерация музыки

Списания по тарифу

Запрос на создании очереди
/api_ai/generate_text2music HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: Текст песни
category: cover(Создать кавер) или song(Создать песню) или melody(Создать мелодию)
style: Стиль аудио(pop,hip-hop,rock и тд)

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text2music HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success":true,
"queueid":"12927350",
"public_music":'Прямая ссылка на ваш файл с результатом',
"public_music2":'Прямая ссылка на ваш файл с результатом'
}

Генерации на English

Генерация заголовков

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: 1-3 секунды
  * Длина заголовков: 70 символов (в среднем)
  * _Примечание_: **num_titles** - количество заголовков, которые должна сгенерировать модель. Значение целочисленное от 1 до 5 (по умолчанию: 1)

Запрос на создании очереди
/api_ai/generate_title_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required
num_titles: int - required ` # max: 5`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_title_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Inflation still a top issue for Democrats with November elections"
}

Генерация продолжения к тексту

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 3-10 секунд
  * Рекомендуемое кол-во слов на входе: от 10
  * Кол-во символов (с учётом пробелов) на выходе после генерации: от 700 до 4000 (в среднем 1200-1600)
  * Хорошо работает с текстами новостного плана. Популярные категории: политика, шоу-бизнес, экономика и новости в мире (всего нейросеть может поддержать свыше 100 направлений).

Запрос на создании очереди
/api_ai/generate_text_ataboba_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text_ataboba_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Prince William penned a personal tweet on Tuesday morning, ahead of the beginning of a new investiture ceremony. He wrote on Twitter: \"Pleased to be back doing investitures in person after a year of shielding.\" The Duke of Cambridge continued: \"On behalf of all of us at @RoyalFamily, I wish the Queen and her family every success in their future endeavours.\" Kensington Palace said in a statement: \"The Prince of Wales will be marking his 90th birthday tomorrow, so the Queen has asked that he not make any public appearances until this point, and that he does not attend official engagements.\" It comes as Buckingham Palace announced they have held an emergency meeting with Charles and Camilla. A spokesperson for the palace told Express.co.uk: \"The Prince of Wales is delighted to announce that his birthday will be marked by a private audience. \"This will take place at Windsor Castle from midday on Monday, April 21, until 1pm on Wednesday, April 23. \"During this time, the Prince will be accompanied by His Royal Highness, His Royal Highness Prince Charles and His Royal Highness Princess Anne.\" They added: \"All other royal engagements will therefore take place behind closed doors.\" The announcement was made at Clarence House where a number of people were present including Kate Middleton and Prince William. The couple and their children were not at the event. Kensington Palace also released a statement which read: \"Their Royal Highnesses are very pleased to confirm that Prince Charles and The Duchess of Cornwall will be attending The Queen's 90th Birthday Honours. \"Both families will meet privately at Windsor Castle on Monday afternoon, before returning to Sandringham the following day for a private audience.\"
}

Генерация текста по ключевикам и описанию

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 3-10 секунд
  * Рекомендуемое кол-во символов на входе (заголовок+описание+ключевики): не менее 250 (в среднем 300-500)
  * Кол-во символов (с учётом пробелов) на выходе после генерации: от 400 до 5000 (в среднем 1500)
  * Три входных параметра для генерации: заголовок (title), краткое описание статьи (description_article), ключевые слова (keys_of_article)
  * Все группы ключевиков (даты, локации и т.п.) помещаются в одну строку и перечисляются через запятую. Пример: "Путин, Москва, Всемирная организация здравоохранения, 9 мая".
  * Результат подачи на вход (Слова "Заголовок", "Описание" и "Ключевики" прописывать не надо, всё разделено в API): "Заголовок: ATA Corporation выпустила универсальную проверку текстов TurboCheck; Описание: Сервис TurboCheck предназначен для блогеров, авторов информационных текстов и SEO-экспертов. С помощью искусственного интеллекта в сервисе осуществляются проверки на: привлекательность заголовка, позитивность, дочитываемость и кликбейтность текста, а современные алгоритмы помогают найти проблемы; Ключевики: TurboCheck, ATA Corporation, проверка текста, искусственный интеллект, «Покатим.Ру»"
  * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_text_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
description_article: string - required
keys_of_article: string - required
original_language: string - required `# default: en`
translated_language: string - required `# default en`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_text_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "They explored the difference between businesses engaged in expression and ones simply selling goods; the difference between a client’s message and that of the designer; the difference between discrimination against gay couples and compelling the creation of messages supporting same-sex marriage; and the difference between discrimination based on race and that based on sexual orientation."
}

Генерация отзывов к товарам

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 3-15 секунд для 3 вариантов
    * Минимальное кол-во слов в сумме всех инпутов: 30, максимальное: 512
    * Кол-во символов (с учётом пробелов) на выходе после генерации: от 120 до 1000 (в среднем 300)
    * Хорошо работает с товарами категорий: одежда, обувь, аксессуары к одежде и украшения. Всего изучила 220К товаров по 520 категориям.
    * Входные параметры: **product_title** (заголовок к товару. Например: Refurbished TCL 65" Class 4K Ultra HD (2160p)), **product_category** (категория товара. Например: Electronics), **product_parameters** (параметры товара), brand (название бренда или производитель товара)
    * На выходе: словарь, где ключи - три варианта генерации, а значения - метрика качества генерации (чем ниже - тем лучше), варианты уже отсортированы от лучшего к худшему.
    * Особенности инпутов: в **product_parameters** характеристики перечисляются через точку с запятой (;), а между наименованием категории и значением ставится тире (Display Technology - LED; Resolution - 4K (2160P); Manufacturer - TCL; Screen Size - 65.00"...)
    * Для генерации необязательно заполнять все инпуты, но чем больше будет входных данных - тем качественнее получится генерация.
    * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_review_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
product_title: string - required
product_category: string - required
product_parameters: string - required
brand: string - required
original_language: string - required `# default: en`
translated_language: string - required `# default en`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_review_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"I've been a bit skeptical about this TV because I don't have any reviews, but I'm happy I did. It's in great condition and it's a pretty small TV, so it's not super heavy. The picture is exactly as pictured and the color is better than expected.": 4.56,
"I had a TCL 50\" TV from about 20 years ago. It was replacing my old 75\" TV with newer TCL. If you have a TCL TV you're buying this one and love it! There are no HDMI ports, but the inputs are on the front so that the picture is clear and crisp. The remote control works great too. I have been using it for 10+ months now and there hasnt been any issues with it or any of the issues with it in all of my other tvs.": 7.01,
"I ordered the TCL 65 inch version of this TV on May 17. I love my tv but it's kinda small. My TV is an 8 and the VGA's are always too small. It was very difficult to figure out how to get my TV set up properly. I had to go through the entire process of getting the TV set up right so I made sure I went with the TCL remote and connected. Since I had no set up instructions I decided to purchase the LED version as well. The picture is clear, accurate and beautiful even though the picture has less contrast and light. I feel the picture is still sharp and it is also very bright. I purchased this for my daughter to play her games with her Sony PlayStation 4 Pro. This was a great deal, just bought another one in a different color.": 8.57
}
}

Генерация описаний товаров

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 3-15 секунд для 3 вариантов
    * Минимальное кол-во слов в сумме всех инпутов: 30, максимальное: 512
    * Кол-во символов (с учётом пробелов) на выходе после генерации: от 200 до 1500 (в среднем 600)
    * Хорошо работает с товарами категорий: одежда, обувь, аксессуары к одежде и украшения. Всего изучила 220К товаров по 520 категориям.
    * Входные параметры: **product_title** (заголовок к товару. Например: Refurbished TCL 65" Class 4K Ultra HD (2160p)), **product_category** (категория товара. Например: Electronics), **product_parameters** (параметры товара), brand (название бренда или производитель товара)
    * На выходе: словарь, где ключи - три варианта генерации, а значения - метрика качества генерации (чем ниже - тем лучше), варианты уже отсортированы от лучшего к худшему.
    * Особенности инпутов: в **product_parameters** характеристики перечисляются через точку с запятой (;), а между наименованием категории и значением ставится тире (Display Technology - LED; Resolution - 4K (2160P); Manufacturer - TCL; Screen Size - 65.00"...)
    * Для генерации необязательно заполнять все инпуты, но чем больше будет входных данных - тем качественнее получится генерация.
    * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_description_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
product_title: string - required
product_category: string - required
product_parameters: string - required
brand: string - required
original_language: string - required `# default: en`
translated_language: string - required `# default en`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_description_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"This item is REFURBISHEDTCL's 65\" Class HDR TV delivers the best picture and entertainment experience ever in an ultra-hdr display. The 4K technology provides superior contrast, color, and clarity for multitasking. It supports Dolby Atmos and AI to deliver a more natural viewing experience with clearer soundstages that help you see your favorite movies and games at clearer levels. It also has 1080p video up to 60fps. It comes with 4 HDMI ports and 1 USB cable. What's Included: TCL 65\"class 4K Ultra HD (2160p) Dolbie Vision HDR Roku Smart QLED TV (65R625-B) TCL Item Specifications Resolution: 4K Resolution: 2160P Screen Size: 68.5\"W x 56.9\"D x 36\"H Content Type: TV Remote Control Length: 55.2\" Width: 12.99\" Weight: 54.20lbs Product Dimensions: 12.4\" H x 58.8\" W x 16.00\" D Weight: 56.18lbs": 4.54,
"This item is REFURBISHEDThe TCL 65\" class 4K Ultra HD (2160p) Dolby Vision QULED TV (65R625-B) has received all of its major updates and is in excellent condition with minimal to no scratches, scuffs or blemishes present. It comes with the latest DTS Smart Motion Technology and VGA Audio Outputs, so you can enjoy the best of both worlds! The TCL TV runs on the latest technologies such as Q-Synchro and Dolfer, which delivers advanced content and enhanced picture quality for all your favorite movies and shows. TCL also offers Dolbie Vision motion detection technology that helps control your TV like never before. Take advantage of the new smart tv's built-in AI to create your own custom video experience. The TPL TV uses the latest generation of QLED technology to deliver richer colors, a smoother contrast, and deeper color depth, creating more vibrantly detailed visuals that are crisp and sharp. With Dolbear mode, you can choose between Dolber mode, Dolben Mode, or Smart Game Mode.": 5.88,
"This TCL 65\" Class 4K Ultra HD (2160p) Dolby Vision HDR Roku Smart QLED TV (65R625-B) is a smart TV in the most affordable form. With an incredible 1080p resolution and a amazingly low price, this TV can be your favorite. It's also designed for performance, with the TCL Iridium Optics technology that gives you more detail and accentuates the details on your screen without being too intense. The TCL 64\" class model comes standard with the powerful Dolbear motion processor for superior streaming performance in every room of your home. You'll experience smoother images and sharper colors through its 4K display. Get up to 5 times more pixels than your average screen thanks to the precision lens design and full frame rate. With Dolben transitioning from monochrome backlighting to sterile color over black, it lets you enjoy vibrant picture quality while the powerful LED light technology produces amazing contrast across any viewing angle.Refurbished TCL65\" Class (4K UltraHD (2160P) Dollby Vision AI QLEDTV (65r625-4B)": 9.12
}
}

Генерация отзывов и описаний к товару по фото

Списания по тарифу

При генерации списываются текстовые попытки

* Время: 2-10 секунд
  * Поддерживаемые форматы: jpg, jpeg, png, webp
  * Доступные разрешения изображений: от 64х64 до 7680х4320 (чем больше, тем дольше обрабатывает)
  * Максимальный размер: 20 Мб
  * Средняя длина генерируемых отзывов: 425 символов
  * Средняя длина генерируемых описаний: 590 символов
   * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_image2params_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required (URL)
category: string - required (review, description)
original_language: string - required `# default: en`
translated_language: string - required `# default en`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_image2params_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
"I ordered this dress to wear to a wedding and it was perfect! The color is so pretty and the fit is perfect. I am 5'2\" and the length hits just above my knees. I love it and would highly recommend. I love the way it looks on me.",
"I love this dress. It is true to size and very comfortable! The color is true to the picture and the material is so soft. I purchased two dresses from this company in different colors. I am a plus size woman and I was very pleased with my purchase. This dress will be great for my future mother in law."
]
}

Рерайт по предложениям

Списания по тарифу

При генерации списываются текстовые попытки

* Время: ~1-2 сек./6 слов
  * Минимальное количество слов в тексте: 30
  * по user_id получаем сгенерированный текст
  * current_text в response - текущее завершенное предложение
  * number_of_texts в response - общее количество предложений

Запрос на создании очереди
/api_ai/generate_paraphraser_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required (если user_id не передаётся)
user_id: string - required (если content не передаётся)

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_paraphraser_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
responce (если передавать user_id):
"success": true,
"error": "",
"data": {
"input_text": "Here's where things stand on Novak Djokovic's visa saga. What is happening right now? A hastily convened Federal Court hearing adjourned after lunch. Three judges are now considering submissions made by both parties. When will we get a decision? That's not clear. Chief Justice James Allsop said the judges would endeavor to give some guidance later Sunday, but he said another hearing may need to be listed for Monday morning. Isn't that a bit tight? In a word, yes. The Australian Open is set to start on Monday, with top seed Djokovic due to play his countryman Miomir Kecmanovic on Monday night. What did Djokovic's lawyers tell the court? They're challenging the immigration minister's decision to cancel Djokovic's visa on three grounds. The first and main ground is that the minister failed to properly consider the consequences of canceling his visa. Djokovic's lawyer Nick Wood said Immigration Minister Alex Hawke's decision to revoke his client's visa was \"irrational\" as he failed to consider the \"binary alternative\" that the act itself could galvanize anti-vaxxers. Wood said Hawke relied on one news article from January 6 that quoted Djokovic as saying he opposed vaccination in April 2020. But Hawke didn't seek out Djokovic's current views, Wood said. How did the minister's lawyers respond? Stephen Lloyd, acting for Hawke, said the minister didn't seek his current views because Djokovic's anti-vax attitudes were apparent by his failure to be vaccinated. He said the tennis star had plenty of opportunities to be inoculated before his arrival in Australia.",
"results": [
{
"origin_sentence": "Here's where things stand on Novak Djokovic's visa saga.",
"predictions": [
"Here is where things stand on Novak Djokovic's Visa Saga."
]
},
{
"origin_sentence": "What is happening right now?",
"predictions": []
},
...
{
"origin_sentence": "Stephen Lloyd, acting for Hawke, said the minister didn't seek his current views because Djokovic's anti-vax attitudes were apparent by his failure to be vaccinated.",
"predictions": [
"Stephen Lloyd, acting for Hawke, said that the minister did not seek his current views because Djokovic's anti-vax attitudes were evident by his failure to be vaccinated.",
"Stephen Lloyd, acting for Hawke, said the minister did not seek his current views because Djokovic's anti-vax attitudes were evident by his failure to be vaccinated.",
"Stephen Lloyd, acting for Hawke, said that the minister did not seek his current views because Djokovic's anti-vax attitudes were apparent by his failure to be vaccinated."
]
},
{
"origin_sentence": "He said the tennis star had plenty of opportunities to be inoculated before his arrival in Australia.",
"predictions": [
"He said that the tennis star had plenty of opportunities to be inoculated before arriving in Australia.",
"He said that the tennis star had plenty of opportunities to be inoculated before his arrival in Australia."
]
}
],
"current_text": 19,
"number_of_texts": 19
}
```
responce (если передавать content):
"success": true,
"error": "",
"data": {
"user_id": "75704958e78dbf22df029067245a79ce"
}

Генерация рерайта всего текста

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: ~4 секунд на 1000 символов.
  * Ограничения по длине текста в запросе: от 1 до 1050 слов.
  * Длина текста после генерации: не более чем на 25% длиннее текста в запросе.
  * Timeout (sec): 300
  * _Примечание_:

    **conversion_level** - степень преобразования рерайта нейросети. Значение целочисленное от 0 до 10, где 0 - меньше всего изменений, а 10 - больше всего
   * Языки указываются по ISO 639-1 [список поддерживаемых языков](https://cloud.yandex.com/en-ru/docs/translate/concepts/supported-languages)

Запрос на создании очереди
/api_ai/generate_rewrite_text_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required
conversion_level: int - required ` # default: 5`
original_language: string - required `# default: en`
translated_language: string - required `# default en`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_rewrite_text_en HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"input_text": "Representative John Katko of New York, a centrist Republican who broke with his party last year to vote to impeach former President Donald J. Trump, announced on Friday that he would not run for re-election. Mr. Katko was one of 10 House Republicans to vote to impeach Mr. Trump and is the third member of that group to announce his retirement.",
"results": [
"Rep. John Katko, a centrist Republican who broke with his party last year to vote to impeach former President Donald J. Trump, announced on Friday that he would not run for re-election. Katko was one of 10 House Republicans who voted to impeach Mr. Trump and is the third member of that group to announce his retirement.",
"Rep. John Katko, a centrist Republican who broke with his party last year to vote to impeach former President Donald J. Trump, announced on Friday that he would not run for re-election. Katkof, whose party broke with him last year in a vote to oust former President Trump, is the third member of that group to announce his retirement. Katkos, 59, is a Republican who has been a key figure in the House of Representatives since the midterm elections in November."
]
}
}

Корректировка текста

Автоматическая расстановка точек и запятых

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: ~1 сек./1000 символов
  * Модель автоматически расставляет запятые и точки в текстах объёмом от 30 до 550 слов.

Запрос на создании очереди
/api_ai/punctuation_text HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/punctuation_text HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Сегодня на собрании были: менеджер, секретарь, SEO-эксперт и 38 программистов. Все они заявили, что избавиться от кондиционера, несмотря на большие затраты, будет неправильно, ведь на улице 40-градусная жара."
}

Орфографический редактор (исправление опечаток)

Списания по тарифу

При генерации списываются текстовые попытки

* Возвращает исправленные слова
  * Время: ~5 сек./100 слов

Запрос на создании очереди
/api_ai/orthography-corrector HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/orthography-corrector HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [{'correct_word': 'Путин', 'start': 0, 'stop': 5},
{'correct_word': 'сказал', 'start': 6, 'stop': 12},
{'correct_word': 'году', 'start': 25, 'stop': 29},
...
{'correct_word': 'вала', 'start': 654, 'stop': 659}]
}

Переводы

Переводчик

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: ~1-2 сек./1000 символов
  * Языки указываются по ISO 639-1 [список поддерживаемых языков]

Запрос на создании очереди
/api_ai/generate_translate HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required
original_language: string - required. С какого языка перевести
translated_language: string - required. На какой язык перевести

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/generate_translate HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "Какой-то переведённый текст"
}

Анализ текста

Метод Кликбейт

Списания по тарифу

При генерации списываются текстовые попытки

Запрос на создании очереди
/api_ai/predict HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/predict HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"prediction": {
"not_clickbait": "93.06%",
"clickbait": "7.40%"
}
}

Привлекательность заголовка

Списания по тарифу

При генерации списываются текстовые попытки

Запрос на создании очереди
/api_ai/boring_title HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/boring_title HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"prediction": {
"boring_title": "30.57%",
"interesting_title": "69.43%"
}
}

Привлекательность сниппета

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: 0.3-1 с.
  * На вход подаётся заголовок и текст. Заголовок не менее 4 слов
  * Заголовок автоматически перед проверкой обрезается до 60 символов. Текст - до 160 (Google) и 300 (Яндекс).

Запрос на создании очереди
/api_ai/interesting_snippet HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/interesting_snippet HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"googleSearch": 77,
"yandexSearch": 79,
"averageSuccess": 78
}
}

Скучность статьи

Запрос на создании очереди
/api_ai/boring_article HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/boring_article HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"prediction": {
"boring_article": "7.40%",
"interesting_article": "93.06%"
}
}

Анализ текста

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: 0.1-0.5 с.
  * Проверка включает в себя:
      * кол-во символов (symbols_count)
      * кол-во символов без пробелов (symbols_count_without_space)
      * кол-во слов (words_count)
      * кол-во слов без учёта стоп-слов (words_count_without_stop_words)
      * вода в тексте (water)
      * спам в тексте (spam)
      * тошнота текста (nausea)
      * повторы слов (double_words, double_2words, double_3words)
      * список стоп-слов (stopwords)
      * проверка на успешность текста (success_text)
      * простота языка (index_ARI)
      * список длинных слов (long_words)
      * список длинных предложений (long_sentences)
      * список результатов проверки по закону Ципфа (cipfa)
      * плотность ключевиков (word_density)

Запрос на создании очереди
/api_ai/text_information HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/text_information HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
'symbols_count': 353,
'symbols_count_without_space': 314,
'words_count': 43,
'words_count_without_stop_words': 35,
'water': 18.6,
'spam': 28.57,
'nausea': 11.63,
'double_words': [
{'lemmatize_word': 'болградский','word_count': 2,'original_word_list': ['Болградском', 'Болградский'], "word_density": "8.33%"},
{'lemmatize_word': 'район','word_count': 2,'original_word_list': ['районе', 'район'], "word_density": "8.33%"},
{'lemmatize_word': 'административный','word_count': 2,'original_word_list': ['административных', 'административной'], "word_density": "8.33%"},
{'lemmatize_word': 'целостность','word_count': 2,'original_word_list': ['целостность', 'целостности'], "word_density": "8.33%"},
{'lemmatize_word': 'болгарский','word_count': 2,'original_word_list': ['болгарской', 'болгарского'], "word_density": "8.33%"}],
...
'cipfa': [
{"lemmatize_word": "сейчас",
"word_count": 4,
"original_word_list": ["Сейчас"],
"word_density": "16.66%",
"cipfa": 4,
"compliance": "100%",
"recommendation": 0
}
]
}

Простота языка текста (удобочитаемость)

Списания по тарифу

При генерации списываются текстовые попытки

* Время выполнения запроса: до 0.2 секунды
  * Возвращает результаты по шкале 0-100, где 0 - сложный текст, а 100 - легко читать
  * В description возвращается одно из шести разных описаний в зависимости от значения

Запрос на создании очереди
/api_ai/index_ari HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/index_ari HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"ari": 4.53,
"description": "Сложный для восприятия текст. Рекомендуем избавиться от длинных слов и предложений, чтобы читателю было проще разобраться в теме."
}
}

Токсичность текста

Списания по тарифу

При генерации списываются текстовые попытки

Запрос на создании очереди
/api_ai/predict_toxic HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/predict_toxic HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"prediction": {
"toxic": "98.88%",
"positive": "1.12%"
}
}

Дочитываемость статьи для Ядекс.Дзен

Списания по тарифу

При генерации списываются текстовые попытки

* Значение возвращается в % (от 0 до 100)
  * Время: 0.1-0.5 с (зависит от объёма текста)
  * Адекватное предсказание будет при длине текста от 700 символов (с учётом пробелов). Чем больше информации - тем точнее предсказание.

Запрос на создании очереди
/api_ai/predict_stopread_dzen HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/predict_stopread_dzen HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": "86.02%"
}

Актуальность темы

Списания по тарифу

При генерации списываются текстовые попытки

Запрос на создании очереди
/api_ai/relevance_score HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
category: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/relevance_score HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"total_score": {
"relevance_score": "1.03"
}
}

Тренды сейчас (ТОП-10)

Списания по тарифу

При генерации списываются текстовые попытки

* _Примечание_: **original_language** - язык, на котором сформировать сводку трендов. В ответе максимум 10 событий.

Запрос на создании очереди
/api_ai/realtime_trends HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
original_language: string - required ("en" или "ru") ` # default: ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/realtime_trends HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
{
"keywords": "Брижит Макрон, Джилл Байден, Эмманюэль Макрон, Джо Байден, Белый дом, Франция, Президент США, Первая леди Франции",
"url": "https://graziamagazine.ru/fashion/bitva-naryadov-pervyh-ledi-dzhill-bayden-poziruet-v-rozovom-total-luke-a-brizhit-makron-v-zelenom-plate/",
"title": "Битва нарядов первых леди: Джилл Байден позирует в розовом тотал-луке, а \nБрижит Макрон — в зеленом платье | Журнал GRAZIA"
},
{
"keywords": "Иван Христофорович Баграмян, Великая Отечественная война, Музей Победы, Маршал Советского Союза, Рабоче-крестьянская Красная армия",
"url": "https://eadaily.com/ru/news/2022/12/02/v-armyanskoy-stolice-pochtili-pamyat-polkovodca-velikoy-otechestvennoy-voyny",
"title": "В армянской столице почтили память полководца Великой Отечественной войны"
}
]
}

Анализ трендов по ключевикам

Списания по тарифу

При генерации списываются текстовые попытки

* _Примечание_: **original_language** - язык, на котором сформировать сводку трендов. Ответ формируется с разбиением по дням. Всего 31 день.

Запрос на создании очереди
/api_ai/keywords_trend_history HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
original_language: string - required ("en" или "ru") ` # default: ru`

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/keywords_trend_history HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": [
{
"keywords": "Брижит Макрон, Джилл Байден, Эмманюэль Макрон, Джо Байден, Белый дом, Франция, Президент США, Первая леди Франции",
"url": "https://graziamagazine.ru/fashion/bitva-naryadov-pervyh-ledi-dzhill-bayden-poziruet-v-rozovom-total-luke-a-brizhit-makron-v-zelenom-plate/",
"title": "Битва нарядов первых леди: Джилл Байден позирует в розовом тотал-луке, а \nБрижит Макрон — в зеленом платье | Журнал GRAZIA"
},
{
"keywords": "Иван Христофорович Баграмян, Великая Отечественная война, Музей Победы, Маршал Советского Союза, Рабоче-крестьянская Красная армия",
"url": "https://eadaily.com/ru/news/2022/12/02/v-armyanskoy-stolice-pochtili-pamyat-polkovodca-velikoy-otechestvennoy-voyny",
"title": "В армянской столице почтили память полководца Великой Отечественной войны"
}
]
}

Стилистика текста

Списания по тарифу

При генерации списываются текстовые попытки

* Время получения ответа (на 1000 символов): 2 с
  * На вход подаётся модель и текст
  * Результат - категории стилистических ошибок текста и определение стиля речи текста с помощью нейросети.

Запрос на создании очереди
/api_ai/style_text HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
content: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/style_text HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"text_style": [
{
"word": "также",
"category": "канцеляризмы",
"tip": "Такие связки часто усложняют чтение или придают тексту чересчур книжный, канцелярский стиль.",
"description": "Слово или оборот речи, используется в стиле деловых бумаг и документов. Обычный текст делает скучным для читателя."
},
{
"word": "например",
"category": "вводные слова",
"tip": "Алгоритмы «Яндекс», Google и других компаний считают вводные слова «паразитами» и понижают рейтинг за их переизбыток.",
"description": "Слова и словосочетания, которые не являются членами предложения и не несут смысловой нагрузки."
}
],
"speech_style": {
"0": "научный"
}
}
}

Проверка по выбранным показателям

Списания по тарифу

При генерации списываются текстовые попытки

Запрос на создании очереди
/api_ai/general_check HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required
content: string - required
category: string - optional
api_list: array - required (ключи name из объектов API available_api)

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/general_check HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"predicts": {
"clickbait": {
"not_clickbait": "6.04%",
"clickbait": "93.96%"
},
"stopread": {
"percent_stopread": "67.28%"
},
"toxic": {
"toxic": "2.36%",
"positive": "97.64%"
},
"read_45_seconds": {
"percent_reading_45seconds": "72.37%"
},
"relevance_score": {
"relevance_score": "49.02%"
},
"style_text": [
{
"word": "думают",
"category": "вводные слова",
"tip": "Алгоритмы «Яндекс», Google и других компаний считают вводные слова «паразитами» и понижают рейтинг за их переизбыток.",
"description": "Слова и словосочетания, которые не являются членами предложения и не несут смысловой нагрузки."
}
],
"index_ari": {
"ari": 69.1,
"description": "В тексте присутствует терминология, которую знает не каждый человек. Но большинство выпускников школ смогут разобраться в Вашем материале."
},
"interesting_snippet": {
"googleSearch": 91,
"yandexSearch": 90,
"averageSuccess": 90
}
}
}

Подсказки к заголовкам

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: до 0.2с.
  * В data хранится словарь, где ключ статичен, а значение в случае наличия рекомендаций отдаёт tip (подсказка) и values (значения, которые надо подсветить). Если подсказки нет, то по ключу возвращает пустой словарь.
  * Длина подсказки: от 200 до 650 символов
  * Всего 6 подсказок (одновременно может возвращаться 5), которые показывают морфологические и синтаксические проблемы заголовка.
  * В подсказках для типов **tip_verbs** и **tip_boost_title** в значении возвращается пустой массив т.к. по умолчанию для подсветки выделяется весь заголовок.

Запрос на создании очереди
/api_ai/tips_title HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
title: string - required

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/tips_title HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
"tip_verbs": {},
"tip_verbs_tense": {
"tip": "Постарайтесь использовать глаголы в прошедшем времени. Они показывают, что действие уже завершено и результат не изменить. Например: «Учёные обвинили пингвинов в глобальном потеплении» и «Учёные обвинят пингвинов в глобальном потеплении» - действие в будущем вызывает меньше эмоций, чем состоявшееся. Если тематика статьи не позволяет это сделать или в заголовке несколько глаголов, то можно проигнорировать подсказку.",
"values": [
"научат"
]
},
"tip_long_words": {},
"tip_len_title": {},
"tip_water_title": {
"tip": "Выражайте в заголовке больше конкретики. Отклонение от сути негативно сказывается на кликабельности сниппета Вашей статьи. Количество союзов, предлогов и наречий всегда можно уменьшить - посмотрите на выделенные слова и попробуйте исправить это. Помните: «вода» в заголовке приводит к падению CTR и читаемости Ваших статей в дальнейшем.",
"values": [
"на",
"военные",
"к"
]
},
"tip_boost_title": {
"tip": "Для повышения привлекательности Вашего заголовка попробуйте использовать слова-усилители. Например: «Учёные впервые смогли вылечить лень», где слово «впервые» сразу привлечёт внимание читателя - убедитесь в проверке «привлекательность заголовка». Помните: читателю всегда интересно читать о новшествах, лучших достижениях и темах, где что-то предлагают бесплатно. Но будьте осторожны, ведь неправильное использование может привести к кликбейту и повлечь санкции со стороны агрегаторов.",
"values": []
}
}
}

ТОП-10 привлекательных сниппетов из Яндекс и Google

Списания по тарифу

При генерации списываются текстовые попытки

* Время отклика: ~16 сек./1 запрос
  * Проверка с помощью Selenium и алгоритма с нейросетью для привлекательности сниппета

Запрос на создании очереди
/api_ai/top10_snippets HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:create_queue
search_text: string - required. Поисковый запрос

Ответ с данными очереди в формате JSON
{QUEUEID} - Номер вашей очереди, далее обращаемся за получением результата использую этот массив данных. {"success":true,"queueid":{QUEUEID}}
Делаем запрос на получение результата
/api_ai/top10_snippets HTTP/1.1
Host: turbotext.ru
Authorization: Bearer {APIKEY}
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

do:get_result
queueid:{QUEUEID}

Ответ с данными генерации в формате JSON
Если генерация завершена вы получите success=true, если вы получили action=reconnect отправляем запрос заново, после получения success=true получаем данные генерации
{
"success": true,
"error": "",
"data": {
'text_search': 'Поисковый запрос',
'yandex_number_search': 'Нашлось 68 млн результатов',
'google_number_search': 'Результатов: примерно 710 000 000',
'snippet_info' : [
{
"short_link": "zen.yandex.ru",
"link": "https://zen.yandex.ru/media/id/5cf58c035e041200afdaa95a/seo-programmy-dlia-prodvijeniia-saita-seo-soft-600e1538cdf9ab055a735c81",
"source": "yandex",
"title": "Заголовок сниппета",
"text": "Текст сниппета",
"interesting_snippet": 68
}
]
}
}

Примеры

Пример на PHP

<?
class Turbotext_api{

  var $server='https://www.turbotext.ru/api_ai';
  var $token='XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';

  public function generate($url,$data=[]){

    //create queue
    $data['do']='create_queue';
    $result=$this->send_request($url,$data);
    $this->queue=json_decode($result,1);

      //для стандартных запросов
      if($this->queue['success']==true){
      if($this->queue['queueid']>0){
         //get result
         $this->get_result($url,['do'=>'get_result','id'=>$this->queue['queueid']]);
      }
      //Для асинхронных запросов
      elseif($this->queue['asyncid']){echo 'Ваш запрос принят и будет обработан, результат будет отправлен на Webhook URL';}
    }
    else{
      echo 'Ошибка';
      echo $result;
      exit();
    }
  }

  public function get_result($url,$data){
    if($this->counter>10){return ['success'=>false,'error'=>'timeout'];}

    $result=$this->send_request($url,$data);
    $this->result=json_decode($result,1);
    if($this->result['action']=='reconnect'){
      sleep(3);
      $this->counter++;
      return $this->get_result($url,$data);
    }
    else{
      echo $result;
      exit();
    }

    return $this->result;
  }

  public function send_request($url,$data=[]){

    $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL,$this->server.$url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);

    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 8);
    curl_setopt($ch, CURLOPT_TIMEOUT, 120);

        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
     'Authorization: Bearer ' . $this->token
    ));

        $result=curl_exec($ch);

        curl_close($ch);

    return $result;
  }


}

$api = new Turbotext_api();
echo $api->generate('/smart_ai',['content'=>'Где растут ананасы']);
?>



Пример webhook.php

<?
header('Content-Type: application/json; charset=utf-8');
$result=json_decode(file_get_contents('php://input'),1);
if($result['success']==true){
  echo '{"success":true}';
}
else{
  echo '{"success":false}';
}
//Запишем результат чтобы убедиться что результат получен на Webhook
file_put_contents(__DIR__."/test.result.json",file_get_contents('php://input'));
?>