> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Doctor vs. Institucional

> Dos formas de integrar la Scribe API: un solo médico, o una institución que aprovisiona a muchos médicos.

La Scribe API tiene dos superficies de integración. Comparten el mismo flujo central de
consulta — definir un contexto, ejecutar el scribe, obtener el registro. Se diferencian
en **quién aprovisiona las cuentas de médico** y en la clave con la que se autentica.

## API Doctor

Use la API Doctor cuando integra para **una cuenta de médico que ya existe**. Telepatia,
o su propia integración institucional, creó la cuenta y le entregó su clave secreta.

El flujo es un único ciclo de consulta:

1. **Defina el contexto de la consulta** — datos del paciente y una Smart Template.
2. **Inicie el scribe** para el clínico (o transmita una sesión en vivo).
3. **Obtenga los resultados** — la sesión de scribe y el documento de registro médico.

La API Doctor no crea cuentas, sucursales ni webhooks.

## API Institucional

Use la API Institucional cuando su plataforma **aprovisiona y gestiona a muchos médicos
por sí misma**. Es un superconjunto de la API Doctor: agrega una capa de gestión, y cada
médico sigue ejecutando el flujo Doctor anterior.

El flujo tiene primero un paso de aprovisionamiento, y luego el mismo ciclo de consulta
por médico:

1. **Aprovisione la institución** — cree [cuentas](/es/scribe-api/accounts) de médico y
   sucursales. Cada cuenta devuelve su propia clave secreta de médico.
2. **Configure los controles de la institución** — [webhooks](/es/scribe-api/webhooks) y
   [auditorías](/es/scribe-api/audits), autenticados con la clave institucional.
3. **Ejecute cada consulta** — con la clave de ese médico, siga el flujo Doctor anterior.

## ¿Cuál uso?

|                                         | API Doctor                       | API Institucional   |
| --------------------------------------- | -------------------------------- | ------------------- |
| Quién crea las cuentas de médico        | Telepatia                        | Su plataforma       |
| Clave                                   | Clave secreta de médico (`sk_…`) | Clave institucional |
| Crear cuentas y sucursales              | No                               | Sí                  |
| Webhooks y auditorías de la institución | No                               | Sí                  |
| Ejecutar una consulta                   | Sí                               | Sí, por médico      |

<Note>
  Cada endpoint de la API Doctor también está disponible con la clave institucional. La
  API Institucional solo **agrega** la gestión de cuentas, sucursales, webhooks y
  auditorías sobre el mismo flujo de consulta.
</Note>

Siguiente: [Autenticación](/es/scribe-api/authentication) explica los tipos de clave, y el
[Inicio rápido](/es/scribe-api/quickstart) recorre el flujo de consulta de principio a fin.