Документация API

Базовый URL: https://api.docuvox.ru/v1
Версия API: 1.0
Формат: JSON

DocuVox AI API позволяет интегрировать возможности автоматического распознавания речи и AI-анализа в ваши медицинские информационные системы.

Аутентификация

Все запросы к API требуют авторизации через API ключ в заголовке:

Authorization: Bearer YOUR_API_KEY

Распознавание речи

POST /speech/transcribe

Загрузка аудио для распознавания речи

Параметры запроса:

{
  "audio_file": "base64_encoded_audio",
  "format": "wav|mp3|m4a",
  "language": "ru-RU",
  "speakers": ["doctor", "patient"],
  "medical_context": true
}

Ответ:

{
  "transcription_id": "trans_abc123",
  "status": "completed",
  "segments": [
    {
      "speaker": "doctor",
      "text": "Расскажите о ваших жалобах",
      "start_time": 0.5,
      "end_time": 2.1,
      "confidence": 0.95
    }
  ]
}

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

POST /protocols/generate

Создание медицинского протокола на основе транскрипции

Параметры запроса:

{
  "transcription_id": "trans_abc123",
  "template": "therapeutic_consultation",
  "patient_data": {
    "age": 45,
    "gender": "female"
  }
}

Ответ:

{
  "protocol_id": "prot_xyz789",
  "sections": {
    "complaints": "Головная боль в височной области",
    "anamnesis": "Беспокоит в течение недели",
    "examination": "АД 120/80, пульс 72",
    "diagnosis": "Головная боль напряжения",
    "recommendations": "Режим труда и отдыха"
  }
}

AI-подсказки

POST /ai/suggestions

Получение AI-рекомендаций на основе симптомов

Важно: AI-подсказки носят справочный характер и не заменяют профессиональную медицинскую оценку

Параметры запроса:

{
  "symptoms": ["головная боль", "тошнота"],
  "patient_data": {
    "age": 45,
    "gender": "female",
    "medical_history": []
  },
  "context": "primary_consultation"
}

Ответ:

{
  "suggestions": [
    {
      "type": "diagnosis",
      "text": "Головная боль напряжения",
      "confidence": 0.85,
      "icd_code": "G44.2"
    },
    {
      "type": "examination",
      "text": "Измерить артериальное давление",
      "priority": "high"
    }
  ]
}

Коды ошибок

Код	Описание
400	Неверный формат запроса
401	Неверный API ключ
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Примеры интеграции

Python

import requests

api_key = "your_api_key"
url = "https://api.docuvox.ru/v1/speech/transcribe"

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

data = {
    "audio_file": audio_base64,
    "format": "wav",
    "language": "ru-RU"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

JavaScript

const apiKey = 'your_api_key';
const url = 'https://api.docuvox.ru/v1/speech/transcribe';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    audio_file: audioBase64,
    format: 'wav',
    language: 'ru-RU'
  })
});

const result = await response.json();

Нужна помощь с интеграцией?

Наша команда готова помочь с интеграцией API в вашу медицинскую систему.

Связаться с разработчиками