API

МедАссист API — Документация

Программный интерфейс для интеграции интеллектуальной обработки медицинских текстов в МИС, ЛИС и другие системы

Обсудить подключение API Reference →

Что такое МедАссист API

МедАссист API позволяет отправлять медицинские тексты на обработку и получать структурированные результаты. API работает по модели always-async: вы отправляете запрос, получаете идентификатор и забираете результат через polling.

Основные возможности:

  • Обработка медицинских текстов (анализы, протоколы, заключения)
  • Два стиля обработки: краткий и развёрнутый
  • Две современные AI-модели на выбор
  • Prepaid-биллинг с прозрачным учётом кредитов
  • Режим Zero-Log для максимальной конфиденциальности
  • Идемпотентность запросов для надёжных интеграций

Два стиля обработки

Endpoint Стиль Подходит для
/v1/text/process/short Коротко и по делу Короткие тексты, быстрые задачи: исправить ошибки, переформулировать, получить краткий вариант
/v1/text/process/long Развёрнуто и структурно Длинные тексты, глубокая обработка: улучшить структуру, добавить форматирование, предложить варианты

Оба endpoint принимают одинаковый формат запроса. Различается серверная логика обработки.

Модели

В ответах API поле model возвращает публичный алиас: MedAssistModel1 или MedAssistModel2.

Модель Характеристика
MedAssistModel1 Быстрее, более собранный и деловой стиль
MedAssistModel2 Лучше в вариативности формулировок и сложных задачах

Обе модели современные и топового уровня. Переключить модель можно в личном кабинете (/cabinet/model/).

Быстрый старт (curl)

Base URL: https://partner.medassistai.ru

curl -sS -c ./cookies.txt \
  https://partner.medassistai.ru/v1/auth/csrf -o /dev/null

2. Извлечь csrftoken

CSRF="$(grep -E '\scsrftoken\s' ./cookies.txt \
  | tail -n 1 | awk '{print $7}')"
echo "CSRF=$CSRF"

3. Авторизоваться и получить access token

curl -sS -b ./cookies.txt -c ./cookies.txt \
  -H "Content-Type: application/json" \
  -H "Referer: https://partner.medassistai.ru/" \
  -H "X-CSRFToken: $CSRF" \
  -X POST https://partner.medassistai.ru/v1/auth/login \
  -d '{"email":"ваш@email.com","password":"ваш_пароль"}'

Сохраните access_token из ответа.

4. Выпустить API-ключ

ACCESS="<ваш access_token>"

curl -sS \
  -H "Authorization: Bearer $ACCESS" \
  -X POST https://partner.medassistai.ru/v1/api-key/rotate

Сохраните api_key.key — полный ключ показывается только один раз.

5. Отправить текст на обработку

API_KEY="keyid.secret_part"
IDEM="demo-$(date +%s)"

# Отправка (202 Accepted)
REQ_ID="$(
  curl -sS \
    -H "Content-Type: application/json" \
    -H "X-API-Key: $API_KEY" \
    -H "Idempotency-Key: $IDEM" \
    -X POST \
    https://partner.medassistai.ru/v1/text/process/short \
    -d '{"text":"Текст для обработки."}' \
  | jq -r '.request_id'
)"

echo "request_id=$REQ_ID"

# Получение результата (polling)
curl -sS \
  -H "X-API-Key: $API_KEY" \
  "https://partner.medassistai.ru/v1/requests/$REQ_ID"

Если статус 202 — запрос ещё обрабатывается, повторите polling через 2 секунды. Если 200 — результат готов в поле output_text.

  • API Reference — полный список endpoint'ов с форматами запросов и ответов
  • Концепции — идемпотентность, биллинг, лимиты, zero-log
  • Примеры кода — готовые примеры на Python, JavaScript и curl
  • Для бизнеса — пилотный проект, цены, кейсы использования
Обсудить подключение