API исправления, перевода и улучшения текста
Единый API исправляет, стилизует и переводит текст. Авторизация выполняется API-ключом из личного кабинета. Каждый запрос требует уникальный Idempotency-Key.
Как начать работу с API
- Создайте аккаунт и подтвердите email по ссылке из письма.
- Откройте личный кабинет. В разделе «API-ключи» укажите название интеграции и нажмите «Создать ключ». Скопируйте ключ сразу: повторно он не показывается.
- Храните ключ на сервере вашей интеграции. Не публикуйте его в коде страницы, репозитории или сообщениях.
- Проверьте доступный баланс в кабинете перед запросом. При необходимости используйте раздел «Пополнить баланс». Условия бонуса для модуля Битрикс24 описаны отдельно ниже.
- Выберите пример запроса ниже и подставьте свой ключ. Для новой обработки создайте новый
Idempotency-Key, а при повторной доставке того же запроса сохраните прежний. Проверьте результат и поляcharged_amountиbalance: суммы возвращаются в копейках.
Для подключения в чатах используйте инструкцию установки модуля Битрикс24.
Бесплатный модуль для Битрикс24 и 100 ₽ на знакомство
Модуль AI-редактора бесплатный, обязательной подписки нет. AI-обработка оплачивается отдельно по мере использования.
После первого подтверждённого подключения портала начисляется 100 ₽ на баланс аккаунта Нейроредактора один раз на портал. Переустановка, смена API-ключа или аккаунта не дают повторного бонуса.
Создайте API-ключ в аккаунте с подтверждённым email, сохраните его в настройках модуля и нажмите «Получить 100 ₽». Нужен публичный HTTPS-адрес портала. После расходования бонуса пополнение добровольное, без автосписаний. Бонус используется для AI-обработки и не выводится в деньги.
Тарифы
| Операция | Цена за начатые 1000 символов |
|---|---|
correct | 0,05 ₽ |
improve | 0,10 ₽ |
translate | 0,10 ₽ |
suggest_reply | 0,10 ₽ |
Стоимость одного действия не превышает 1 ₽. Для подсказки ответа учитывается объём переданной истории чата. Повторная доставка завершённого запроса с тем же Idempotency-Key не оплачивается повторно.
Общие эндпоинты веб-редактора и модуля
Каждый готовый стиль имеет отдельный URL. Промпт и настройки обработки выбираются сервером по ID стиля из единого каталога. Передать другой промпт в эндпоинт готового стиля нельзя. Для своей инструкции используйте /api/v1/text/custom.
Запросы с API-ключом проходят авторизацию и биллинг. Гостевые запросы веб-редактора проходят капчу. Генерация и проверка результата общие. При повторной доставке запроса используйте прежний Idempotency-Key, для новой обработки - новый.
| Функция | POST URL |
|---|---|
| Исправление | /api/v1/text/correct |
| Перевод | /api/v1/text/translate |
| Улучшение текста | /api/v1/text/improve |
| Свой промпт | /api/v1/text/custom |
| Подсказка ответа | /api/v1/text/suggest-reply |
| Корпоративный | /api/v1/text/styles/corporate |
| Формально | /api/v1/text/styles/formal |
| Дружелюбно | /api/v1/text/styles/friendly |
| Короче | /api/v1/text/styles/short |
| Подробнее | /api/v1/text/styles/expand |
| Проще | /api/v1/text/styles/simple |
| Дзен | /api/v1/text/styles/zen |
| Мастер Йода | /api/v1/text/styles/yoda |
| Библейский | /api/v1/text/styles/biblical |
| Викинг | /api/v1/text/styles/viking |
| Шекспир | /api/v1/text/styles/shakespeare |
| Сарказм | /api/v1/text/styles/sarcastic |
| Деловой | /api/v1/text/styles/business |
| Продающий | /api/v1/text/styles/marketing |
| С эмодзи | /api/v1/text/styles/emoji |
curl
curl -X POST https://editor.classnyisait.ru/api/v1/text/styles/formal \
-H "Authorization: Bearer ne_live_ВАШ_КЛЮЧ" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"text":"Ваш текст"}'
JavaScript
const response = await fetch('https://editor.classnyisait.ru/api/v1/text/translate', {
method: 'POST',
headers: { Authorization: 'Bearer ' + apiKey, 'Idempotency-Key': crypto.randomUUID(), 'Content-Type': 'application/json' },
body: JSON.stringify({ text: 'Привет', target_language: 'en' })
});
const data = await response.json();
PHP
$response = Http::withToken($apiKey)
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->post('https://editor.classnyisait.ru/api/v1/text/correct', [
'text' => 'Текст',
]);
charged_amount и balance возвращаются в копейках. Лимит - 60 запросов в минуту на ключ. Полный контракт доступен в OpenAPI 3.1.