API Текстовода и MCP-сервер
Через API и MCP доступны те же сервисы, что на сайте: проверки текста, антиплагиат, ИИ-детектор и ИИ-сервисы. Запросы тратят знаки вашего ПРО, общие с сайтом.
Содержание
- С чего начать
- Как устроен запрос
- Сервисы
- Что лежит в result
- Остатки
- Оплата и лимиты
- MCP-сервер
- Описание OpenAPI
- API 1, прежняя версия
С чего начать
- Подключите ПРО: запросы списывают знаки ПРО.
- Создайте ключ на странице ключей API. Ключ показывается один раз.
- Передавайте ключ в заголовке
Authorization: Bearer ваш_ключ.
Как устроен запрос
Работа идёт в два шага: отправить текст и получить результат по номеру задачи. Запросы и ответы в JSON, кодировка UTF-8.
Отправить текст
POST https://textovod.com/api/v2/text/{сервис}
Authorization: Bearer ваш_ключ
Content-Type: application/json
Accept: application/json
{"text": "Ваш текст", "lang": "ru"}| Поле | Значение |
|---|---|
text | Текст. Обязательное поле, пределы длины зависят от сервиса. |
lang | Язык текста для проверок или язык ответа для ИИ-сервисов. По умолчанию ru. |
id | Только для чата: номер предыдущей задачи, чтобы продолжить диалог. |
Ответ:
{"status": 3, "id": "9f1c2b7e-..."}Получить результат
Пока задача в работе, приходит только статус. Готовый результат лежит в поле result. Результат хранится 7 дней.
POST https://textovod.com/api/v2/text/{сервис}/result
Authorization: Bearer ваш_ключ
Content-Type: application/json
{"id": "9f1c2b7e-..."}Ответ:
{"status": 2, "id": "9f1c2b7e-...", "result": {"text": "..."}}Статусы
3 | задача в очереди |
1 | задача выполняется |
2 | готово, результат в поле result |
0 | ошибка, текст в messages, код в error |
30 | нечем платить: знаки ПРО закончились или ПРО не подключён |
Коды ошибок
no_chars | Знаки ПРО закончились. Докупите знаки на странице ПРО. |
need_pro | ПРО не подключён и остатка баланса нет. |
too_short | Текст короче минимальной длины сервиса. |
unavailable | Сервис временно недоступен, знаки не списаны. |
in_progress | Предыдущее сообщение чата ещё обрабатывается. |
failed | Задачу выполнить не удалось. |
rejected | Запрос отклонён, причина в messages. |
{"status": 30, "error": "no_chars", "messages": ["Знаки ПРО закончились. Докупить знаки: https://textovod.com/pro"]}Коды HTTP
401 | ключ не передан или отозван |
403 | задача принадлежит другому пользователю |
404 | задача не найдена |
422 | неверные поля запроса, подробности в errors |
429 | слишком много запросов |
Сервисы
| Сервис | Что делает | Длина текста | Знаки | Языки |
|---|---|---|---|---|
spelling |
Проверка орфографии. Находит орфографические ошибки и предлагает варианты исправления. Результат приходит сразу. | 1 – 500 000 | ИИ | ru, en, de, fr, es, it, pt |
punctuation |
Проверка пунктуации. Расставляет запятые и другие знаки препинания. | 1 – 100 000 | ИИ | ru, en, fr, es, de, it, pt |
unique |
Проверка уникальности. Антиплагиат: ищет совпадения текста в интернете и считает уникальность в процентах. | 100 – 200 000 | антиплагиат | не задаётся |
ai-detector |
ИИ-детектор. Оценивает, написан ли текст нейросетью, и показывает подозрительные фрагменты. | 250 – 200 000 | антиплагиат | не задаётся |
grammar |
Автокорректор. Исправляет грамматические, орфографические и пунктуационные ошибки, сохраняя смысл и стиль. | 1 – 35 000 | ИИ | больше 100 языков |
paraphrase |
Перефразирование. Переписывает текст другими словами с сохранением смысла. | 1 – 35 000 | ИИ | больше 100 языков |
rewrite |
Рерайт. Автоматический рерайт: заменяет слова и обороты, повышая уникальность текста. | 1 – 100 000 | ИИ | ru |
translate |
Переводчик. Переводит текст на язык, указанный в поле lang. | 1 – 35 000 | ИИ | больше 100 языков |
summarize |
Сокращение текста. Сокращает текст, оставляя главное. | 1 – 35 000 | ИИ | больше 100 языков |
expand |
Расширение текста. Дополняет и развивает текст. | 1 – 35 000 | ИИ | больше 100 языков |
write |
Написать текст по теме. Пишет текст по теме или заданию из поля text. | 1 – 35 000 | ИИ | больше 100 языков |
titletext |
Заголовок для текста. Придумывает заголовок к тексту. | 1 – 35 000 | ИИ | больше 100 языков |
dream |
Толкование снов. Толкует сон, описанный в тексте. | 1 – 35 000 | ИИ | больше 100 языков |
chat |
Чат с нейросетью. Отвечает на сообщение. Чтобы продолжить диалог, передайте id предыдущей задачи. | 1 – 35 000 | ИИ | больше 100 языков |
Что лежит в result
spelling |
count — число найденных ошибок; matches — список ошибок: offset и length — положение в тексте, mes — описание, rep — варианты замены; text — проверенный текст. Результат приходит сразу в ответе на отправку. |
punctuation |
text — текст с расставленными знаками; marked — тот же текст, добавленные знаки в теге mark; details — положения знаков по абзацам и статистика; original — исходный текст. |
unique |
originality — уникальность в процентах; sources — источники совпадений: url, domain, similarity — доля совпадений в процентах; text — проверенный текст. |
ai-detector |
verdict и verdict_title — итог; stats — доля ИИ-текста и подозрительных фрагментов; segments — фрагменты: start, end, type, confidence. |
grammar |
text — исправленный текст. |
paraphrase |
text — перефразированный текст. |
rewrite |
text — переписанный текст; original — исходный текст. |
translate |
text — перевод. |
summarize |
text — сокращённый текст. |
expand |
text — расширенный текст. |
write |
text — готовый текст. |
titletext |
text — заголовок. |
dream |
text — толкование. |
chat |
text — ответ; messages — весь диалог. |
У ИИ-сервисов вместе с result приходит поле messages со всем диалогом, как и раньше.
Остатки
Знаки ПРО по двум счётчикам, срок ПРО и остаток старого рублёвого баланса. Поле pack совпадает с pro.ai.
POST https://textovod.com/api/v2/text/balance
Authorization: Bearer ваш_ключ
{"balance": 0, "pack": 500000, "pro": {"active": true, "until": "2026-10-31 12:00:00", "unique": 300000, "ai": 500000}}Оплата и лимиты
- Проверка уникальности и ИИ-детектор тратят знаки антиплагиата, все остальные сервисы тратят знаки ИИ.
- Сначала тратится месячная квота ПРО, потом запас. Если знаки закончились, списывается остаток старого баланса, пока он есть.
- У ИИ-сервисов считаются и текст запроса, и ответ.
- Расход по дням виден в кабинете на странице «Расход знаков».
- Лимит: 300 запросов в минуту на ключ, включая получение результата.
MCP-сервер
MCP позволяет подключить сервисы Текстовода к ИИ-клиентам: Claude Code, Cursor и другим программам с поддержкой MCP. Адрес сервера: https://textovod.com/mcp
Список инструментов открыт без ключа. Для вызова инструмента нужен тот же ключ API в заголовке Authorization: Bearer.
Инструмент ждёт результат до 20 секунд. Если задача ещё в работе, он возвращает её номер, а результат отдаёт инструмент get-result. Проверка уникальности и ИИ-детектор идут дольше и сразу возвращают номер задачи.
Подключение в Claude Code:
claude mcp add --transport http textovod https://textovod.com/mcp --header "Authorization: Bearer ваш_ключ"Подключение через файл настроек (Cursor и другие клиенты):
{
"mcpServers": {
"textovod": {
"url": "https://textovod.com/mcp",
"headers": {"Authorization": "Bearer ваш_ключ"}
}
}
}Инструменты
| Инструмент | Что делает |
|---|---|
check-spelling | Проверка орфографии |
check-punctuation | Проверка пунктуации |
check-uniqueness | Проверка уникальности |
detect-ai-text | ИИ-детектор |
autocorrect | Автокорректор |
paraphrase | Перефразирование |
rewrite | Рерайт |
translate | Переводчик |
summarize | Сокращение текста |
expand | Расширение текста |
write-text | Написать текст по теме |
make-title | Заголовок для текста |
interpret-dream | Толкование снов |
chat | Чат с нейросетью |
get-result | Результат задачи, которую инструмент не успел дождаться. Знаки не тратит. |
get-balance | Остатки знаков ПРО, срок ПРО и баланс. |
Описание OpenAPI
Машинное описание API 2 для генерации клиентов и проверки запросов: https://textovod.com/api-docs/openapi.json
API 1, прежняя версия
API 1 продолжает работать без изменений и больше не развивается. Новым подключениям подходит API 2: в нём те же четыре сервиса и единый формат.
Номер пользователя и ключ передаются в теле запроса. Они указаны на странице ключей API. Сервисы: punctuation, spelling, unique, rewrite.
POST https://textovod.com/api/{сервис}/user/add
{"user_id": 123, "api_key": "ваш_ключ", "text": "Ваш текст", "lang": "ru"}
POST https://textovod.com/api/{сервис}/user/status
{"user_id": 123, "api_key": "ваш_ключ", "text_id": "..."}Статусы: 0 — ошибка, 3 — в очереди, 1 — обработка, 2 — готово. Орфография отвечает сразу статусом 1. Ошибка приходит в поле info.
В готовом ответе пунктуации приходят поля punctuation, result, text и resultText; уникальности — originality, position, text и urls; орфографии — result, count и text; рерайта — rewrite и text. Списки result и urls приходят строкой JSON.
Лимит: 60 запросов в минуту, для уникальности 180. Слишком длинный текст обрезается: пунктуация и рерайт до 100 тыс. знаков, уникальность до 200 тыс., орфография до 500 тыс.