Zero Data Retention

ZDR es una garantía contractual del proveedor del modelo: el request y la respuesta no se almacenan en ninguna forma (logs, telemetría, caché, fine-tuning). Geek Hub mantiene una lista de endpoints donde esa garantía está firmada y verificada, y rechaza requests con ZDR activo dirigidas a endpoints fuera de la lista.

Tres niveles de activación

Por request

Pasa zdr: true en el body de tu llamada. El gateway verifica el modelo destino contra la lista. Si está verificado, procede; si no, HTTP 422 con motivo.

Por cuenta

En /dashboard/settings → Zero Data Retention activas ZDR permanente por grupo de proveedor (Anthropic, OpenAI, Google, Otros). Cuando un grupo tiene ZDR activo, todas las requests de tu organización a ese grupo se verifican.

Por guardrail

Los guardrails permiten configurar ZDR por usuario o por API key. Útil para equipos con políticas diferentes en la misma org.

Ejemplo de request

curl -X POST https://api.geekhub.mx/v1/chat/completions \
  -H "Authorization: Bearer ghub_sk_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-6",
    "messages": [{"role":"user","content":"Hola"}],
    "zdr": true
  }'

Endpoints con ZDR verificado

Grupo	Modelos	Verificados
Anthropic	claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5	3 / 3
OpenAI	gpt-5, gpt-4.1, gpt-4.1-mini, o4-mini, tts-1, tts-1-hd, gpt-4o-mini-tts	7 / 7
Google	gemini-2.5-pro, gemini-2.5-flash	2 / 2
Otros (DeepSeek, xAI, Moonshot, fal)	—	0 / 8

Lista generada del catálogo en tiempo real. Cuando agregamos un proveedor con ZDR firmado, aparece automáticamente.

Formato del rechazo

{
  "error": {
    "type": "zdr_not_verified",
    "message": "El proveedor del modelo no ofrece política ZDR firmada y verificada por Geek Hub.",
    "model": "deepseek/deepseek-v4-flash",
    "verified_alternatives": ["openai/gpt-5", "anthropic/claude-sonnet-4-6"]
  }
}

ZDR es parte de tu estrategia de cumplimiento del artículo 5(1)(e) del GDPR (limitación del plazo de conservación). Si tu proveedor no retiene la conversación, la conservación en esa capa es efectivamente cero, lo cual reduce el alcance de tus obligaciones de tratamiento upstream.

ZDR cubre la retención del proveedor del modelo. Geek Hub sí almacena metadatos de facturación (model id, tokens, costo, latency) para emisiones CFDI/Stripe. El contenido de los mensajes no se persiste a nivel gateway.

Qué se persiste vs qué no

Sin ambigüedad — así separamos contenido (prompt/respuesta) de metadatos (facturación y auditoría):

Tipo de dato	ZDR activo	Se persiste	Dónde	Retención
Texto de mensajes (user/assistant/system)	Sí	❌ No (solo memoria del request)	—	0
Imágenes en prompt	Sí	❌ No	—	0
Imágenes/videos generados (output)	Sí	✅ Sí (para que puedas descargarlos)	Supabase Storage	Vida útil de tu cuenta o eliminación bajo petición
Tokens de entrada y salida	Siempre	✅ Sí	Postgres `requests`	7 años (obligación fiscal SAT)
Modelo, provider, request_id, timestamp	Siempre	✅ Sí	Postgres `requests`	7 años
Costo USD/MXN por request	Siempre	✅ Sí	Postgres `requests`	7 años
Códigos de error del provider	Siempre	✅ Sí (código, no contenido)	Postgres `requests`	90 días
Logs técnicos del gateway (HTTP status, latency)	Siempre	✅ Sí	stderr → agregador	30 días

Regla clara: cualquier campo capturado a nivel requests es metadata numérica o de identificación. Nunca guardamos el content de messages[] ni el prompt de /images, /videos, /audio, ni siquiera hasheado, ni siquiera con ZDR desactivado. Si necesitas retener conversaciones tú, usa un webhook request.completed desde tu propio backend (ver Webhooks).

Empezar

Conceptos

Features avanzadas

Legal & cumplimiento

Zero Data Retention

Tres niveles de activación

Ejemplo de request

Endpoints con ZDR verificado

Formato del rechazo

Qué se persiste vs qué no

​Tres niveles de activación

​Ejemplo de request

​Endpoints con ZDR verificado

​Formato del rechazo

​GDPR — art. 5(1)(e) data minimization

​Qué se persiste vs qué no

Tres niveles de activación

Ejemplo de request

Endpoints con ZDR verificado

Formato del rechazo

GDPR — art. 5(1)(e) data minimization

Qué se persiste vs qué no