# Documentación

- [Documentación de Callsist](/): APIs de transcripción y comprensión del habla. El contrato completo, verificado contra el código.

- **Empezar**
- Empezar
  - [Autenticación y scopes](/empezar/autenticacion): Claves sk_live_, los siete scopes y qué comprobar antes de escribir código.
  - [Primera transcripción](/empezar/primera-transcripcion): De un mp3 a JSON con hablantes separados, en cuatro llamadas.

- **Guías**
- Guías
  - [Subir audio](/guias/subir-audio): Fichero o URL, formatos admitidos y los cinco parámetros que se aceptan y se ignoran.
  - [Sondear y leer el resultado](/guias/sondear): El ciclo de vida, la respuesta completa y las dos comprobaciones que hay que hacer antes de usar nada.
  - [Los siete módulos de comprensión](/guias/comprension): Temas, moderación, PII, lenguaje, sentimiento, resumen y tareas. Qué devuelve cada uno.
  - [Hablantes y roles](/guias/hablantes): Cuándo fiarse de speakerRole, y por qué el número de confianza solo no basta.
  - [Redacción de PII](/guias/pii): Qué detecta, cómo se tapa y por qué el texto de primer nivel sigue en claro.
  - [Webhooks](/guias/webhooks): Registrar un endpoint, verificar la firma y por qué para un lote propio conviene más sondear.
  - [Análisis con LLM](/guias/llm): Compatible con la forma de OpenAI. Lo que cambia es qué campos se atienden.
  - [Embeddings y RAG](/guias/embeddings): Devolvemos los vectores. El almacén y la búsqueda los pones tú.
  - [Lotes y límites](/guias/lotes): 8 en paralelo, dos claves, y qué reintentar.
  - [n8n](/guias/n8n): El recorrido completo con nodos de n8n, y el nodo que no sirve.

- **Referencia**
- Referencia
  - [Endpoints](/referencia/endpoints): La referencia completa, generada desde los esquemas que validan las peticiones.
  - [Errores](/referencia/errores): Los 28 códigos estables de la API, qué hacer con cada uno y cuáles no se emiten nunca.
  - [Modelos](/referencia/modelos): Los cuatro identificadores utilizables, y por qué no hay más.
  - [Límites y cuotas](/referencia/limites): 300 peticiones por minuto y por clave, 32 transcripciones en vuelo, 2 GB por fichero.
  - [Precios](/referencia/precios): Todo se descuenta de un saldo prepago. Los fallos no se facturan.

- **Producción**
- Producción
  - [Trampas conocidas](/produccion/trampas): Lo que la API acepta y no hace. Leerlo antes ahorra una tarde.
  - [Retención y borrado](/produccion/retencion): Qué se guarda, cuánto, y por qué «caducado» no significa «borrado».