Saltar al contenido principal
La API Codify de Omniscribe proporciona codificación médica ICD-10 impulsada por IA desde notas clínicas, con una precisión superior en un 77% a los LLMs generales. En términos simples: envía una nota clínica (texto o PDF), y la API devuelve evaluaciones estructuradas de códigos ICD-10 con puntuaciones de confianza, justificaciones y análisis detallado del proceso de decisión de la IA.

​
¿Por qué somos diferentes?

A diferencia de LLMs genéricos (ChatGPT, Claude, etc.), utilizamos modelos especializados entrenados específicamente para codificación clínica, logrando:
  • 77% más de precisión que LLMs generales en codificación CIE-10.
  • Reducción del 92% en alucinaciones médicas.
  • Adaptación a tu centro: Modelos personalizados con tus nomenclaturas y flujos.
  • Multilingüe real: Entrenados en español clínico, catalán, euskera, gallego e inglés.

​
¿Para que sirve?

Esta API resuelve problemas críticos de documentación clínica:

​
Codificación Médica ICD-10

  • Extracción automática de códigos ICD-10 desde notas clínicas con análisis impulsado por IA.
  • Puntuaciones de confianza para cada código (0-100%) para apoyar decisiones de codificación.
  • Justificaciones detalladas explicando por qué se seleccionó cada código.
  • Análisis de códigos descartados mostrando códigos rechazados y razonamiento.
  • ROI medible: Reducción del 70% del tiempo de codificación.

​
Facturación y Cumplimiento

  • Asignaciones precisas de códigos para reembolsos.
  • Pista de auditoría con seguimiento run_id para cada sesión de codificación.
  • Seguimiento de doctor y paciente para cumplimiento normativo.
  • Aseguramiento de calidad mediante toma de decisiones transparente de la IA.

​
Listo para Integración

  • Soporte PDF para procesar documentos escaneados (hasta 5MB).
  • Entrada de texto para integración directa con EHR (hasta 50KB).
  • Selección de modelos de IA personalizados para necesidades especializadas.
  • API RESTful con manejo consistente de errores.

​
¿Cómo funciona el proceso?

​
Paso 1: Prepare su nota clínica

Prepare su nota clínica como:
  • Texto plano (hasta 50KB) - desde EHR, dictado o entrada manual
  • Archivo PDF (hasta 5MB decodificado) - documentos escaneados o informes
Opcionalmente, especifique un modelo de IA personalizado para necesidades de procesamiento especializadas.

​
Paso 2: Envíe a la API Codify

Envíe su nota clínica a /v1/codify con headers opcionales de seguimiento para fines de auditoría. Nuestro motor de IA clínica especializado:
  1. Analiza el contexto médico usando modelos entrenados en millones de notas clínicas reales.
  2. Identifica diagnósticos y condiciones médicas con alta precisión.
  3. Asigna códigos ICD-10 apropiados con puntuaciones de confianza.
  4. Proporciona justificaciones detalladas para cada selección de código.
  5. Muestra códigos descartados y por qué fueron rechazados.

​
Paso 3: Reciba evaluaciones de códigos ICD-10

La API devuelve:
  • Evaluaciones de códigos finales: Códigos ICD-10 seleccionados con descripciones, justificaciones y puntuaciones de confianza
  • Evaluaciones descartadas: Códigos rechazados mostrando el proceso de decisión de la IA
  • Run ID: Identificador único para seguimiento y depuración
1

Entrada clínica

Envíe su nota clínica como texto o PDF a la API.
2

Análisis IA

El Motor IA Especializado (+77% mejora de precisión) analiza el contenido clínico.
3

Resultados estructurados

Reciba códigos ICD-10 con puntuaciones de confianza, justificaciones detalladas y códigos descartados con razonamiento — listo para flujos de facturación y codificación.
Ventaja clave: Transparencia completa con puntuaciones de confianza y justificaciones ayuda a los codificadores a tomar decisiones informadas y mantener estándares de calidad.

​
Endpoints disponibles

POST /v1/codify

Codifica texto clínico en una estructura JSON que usted define.

GET /v1/health

Verifica que el servicio está operativo.

​
Playground Interactivo de la API

La documentación incluye un playground interactivo de la API basado en la especificación OpenAPI. Puede probar llamadas a la API directamente desde el navegador sin escribir código.
1

Navegar a la Referencia de API

Vaya a la sección Referencia de API en la pestaña SofIA API, o haga clic aquí.
2

Configurar autenticación

Introduzca su token Bearer en el campo Authorization en la parte superior del playground.
3

Completar la petición

Use los campos del formulario para construir su petición, o cambie a la pestaña Body para pegar JSON directamente. El playground valida su entrada contra el esquema OpenAPI en tiempo real.
4

Enviar e inspeccionar

Haga clic en Send para ejecutar la petición. El panel de respuesta muestra el código de estado, headers y el cuerpo JSON formateado.
El playground usa sus credenciales reales de API. Use datos de prueba (no información real de pacientes) al experimentar.

​
Versionado de la API

​
Esquema de versiones

  • Versionado por ruta: /v1/, /v2/, etc.
  • Cambios compatibles: Se añaden a la versión actual sin romper la API
  • Cambios incompatibles: Incrementan la versión mayor (ej: v1 → v2)
Versión actual: v1.0.0 — Lanzamiento inicial del endpoint público

​
Siguientes pasos

1. Inicio Rápido

Su primera llamada a la API

2. Autenticación

Configuración de tokens y headers

3. Estructura de datos

Peticiones y respuestas

4. Ver ejemplos

Ejemplos prácticos de codificación

5. Operación y errores

Manejo de errores y seguridad

6. Referencia completa

Especificación OpenAPI