API Docs/API Keys Personales
Developer Mode

API Keys Personales

Usa tus propias keys de OpenAI, Anthropic y Google AI para traducir sin límites y con control total de costos.

Requisitos
  • Rol DEV o SUPER_ADMIN
  • API key válida de OpenAI, Anthropic y/o Google AI

¿No tienes rol Developer? Consulta cómo obtenerlo.

Proveedores Soportados

OpenAI
GPT-4o y GPT-4o Mini

Formato de key:

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Modelos disponibles:

gpt-4o-minigpt-4o
Anthropic
Claude Haiku y Claude Sonnet

Formato de key:

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxx

Modelos disponibles:

claude-3-haikuclaude-sonnet-4
Google AI
Gemini 2.0 Flash y Gemini 1.5 Pro

Formato de key:

AIzaSy...

Modelos disponibles:

gemini-2.0-flashgemini-1.5-pro

Configuración

1
Accede a la configuración Developer

Ve a Configuración → Developer. Solo verás esta opción si tienes rol DEV o SUPER_ADMIN.

2
Activa el modo de keys personales

Activa el switch "Usar mis propias API Keys". Esto indica que quieres usar tus keys en lugar de las del sistema.

Usar mis propias API Keys
3
Ingresa tus API keys

Puedes configurar una, dos o las tres keys según los modelos que quieras usar:

  • OpenAI: Para usar GPT-4o y GPT-4o Mini
  • Anthropic: Para usar Claude Haiku y Claude Sonnet
  • Google AI: Para usar Gemini 2.0 Flash y Gemini 1.5 Pro
4
Prueba la conexión

Usa el botón "Probar conexión" para verificar que tus keys son válidas antes de guardar.

Conectado (gpt-4o)
5
Guarda y empieza a traducir

Una vez guardado, todas tus traducciones usarán tus propias keys. El costo de API irá directamente a tu cuenta de OpenAI, Anthropic o Google.

Seguridad

Encriptación AES-256-GCM

Tus API keys se encriptan antes de guardarse en la base de datos usando el estándar AES-256-GCM, el mismo usado por bancos y gobiernos.

Salt único por encriptación

Cada key tiene su propio salt generado aleatoriamente, lo que significa que incluso si dos usuarios tuvieran la misma key, el texto encriptado sería diferente.

Desencriptación solo cuando se necesita

Las keys solo se desencriptan en el momento de hacer la llamada a la API de traducción. Nunca se almacenan en texto plano en memoria o logs.

// Ejemplo de cómo se almacena tu key (encriptada)
"customOpenaiKey": "aes256gcm:salt:iv:authTag:encryptedData"

// Lo que ve el usuario en el dashboard
"openaiKeyMasked": "sk-****...****abc1"

Preguntas Frecuentes

¿Puedo usar solo uno de los proveedores?

Sí, puedes configurar solo una, dos o las tres keys. Si solo tienes key de OpenAI, podrás usar los modelos GPT. Para Claude o Gemini, el sistema usará la key del sistema si no tienes una personal.

¿Qué pasa si mi key expira o es revocada?

Las traducciones fallarán con un error de autenticación. Recibirás un webhook "translation.error" si tienes webhooks configurados. Ve a la configuración Developer para actualizar tu key.

¿Cómo veo cuánto estoy gastando?

El gasto de API va directamente a tu cuenta del proveedor. Puedes ver el consumo en sus respectivos dashboards:

¿Puedo volver a usar las keys del sistema?

Sí, simplemente desactiva el switch "Usar mis propias API Keys" y tus traducciones volverán a usar las keys del sistema (sujeto a los límites de tu plan).

Consideraciones Importantes
Tus keys de OpenAI, Anthropic y Google tienen acceso a todos sus servicios, no solo traducción. Mantenlas seguras.
Si te degradan de DEV a USER, tus keys serán eliminadas automáticamente por seguridad.
Configura límites de gasto en OpenAI, Anthropic y Google para evitar sorpresas en tu factura.

¿Listo para configurar tus keys?

Traduce sin límites usando tus propias API keys

Ir a Configuración DeveloperVer Roles y Permisos