Основы работы с API
Войти или зарегистрироваться
Все запросы отправляются на урл https://www.turbotext.ru/api_ai
Тарифы
Для возможности использовать API для генераций фото, текста, анализа и других методов,
API доступен только для подписчиков на тариф VIP
После покупки тарифа вам будет доступен 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);//Результаты в массиве