Documentación Traiga su propia clave (BYOK)

Traiga su propia clave (BYOK)

Traé tu propia clave (BYOK) para el plan Enterprise: conectá una API key de Google Gemini para desbloquear créditos adicionales, una selección de modelos más amplia y facturación directa.

Resumen

Bring Your Own Key (BYOK) es una funcionalidad exclusiva para Enterprise que permite a su organización conectar una clave de API de Google Gemini directamente a i1n. De esta forma, las traducciones por IA se ejecutan en su propia cuenta de Google AI en lugar de utilizar el pool de inferencia compartido de i1n.

Cuando BYOK está activo, tu contrato Enterprise recibe un bono del +50% en créditos de traducción por IA y claves de traducción, además de los límites negociados. Los costos de inferencia cobrados por Google se facturan a tu propia cuenta de Google; i1n continúa gestionando la orquestación, el almacenamiento en caché, la protección de variables y la aplicación del tono de voz de la marca.

BYOK se configura por organización desde el panel de control. La clave se cifra en reposo y solo se utiliza para realizar llamadas de traducción en su nombre; nunca se registra, exporta ni comparte entre organizaciones.

¿Por qué usar BYOK?

Vale la pena habilitar BYOK cuando se aplique cualquiera de los siguientes casos: su organización ya tiene un acuerdo con Google Cloud o Google AI Studio, necesita visibilidad directa de los costos de la inferencia subyacente, o desea acceso prioritario a los últimos modelos de vista previa de Gemini apenas Google los lance.

El bono del +50% en créditos y llaves significa que un tenant Enterprise con BYOK habilitado paga efectivamente solo por la orquestación, mientras que los costos de inferencia se gestionan a través de su relación de facturación existente con Google, lo que generalmente resulta en un costo total de propiedad más bajo en volúmenes de traducción altos.

BYOK también le brinda una gobernanza más estricta. Puede rotar la clave, establecer cuotas en Google AI Studio y auditar el uso desde un único panel de facturación de Google junto con el resto de sus cargas de trabajo de IA.

Modelos disponibles

Una vez que BYOK esté habilitado, podrás elegir el modelo de Gemini predeterminado para la traducción por IA. El modelo puede cambiarse en cualquier momento desde el panel de control y se aplicará a los trabajos de traducción posteriores.

Gemini 2.5 Flash-Lite es el modelo predeterminado recomendado. Ofrece el mejor equilibrio entre calidad de traducción, latencia y costo para la mayoría de las cargas de trabajo de localización.

Gemini 3 Flash (preview) es adecuado para traducciones generales de mayor calidad cuando la latencia sigue siendo una prioridad. Gemini 3.1 Pro (preview) ofrece la mayor calidad disponible y se recomienda para contenido con matices o de alta importancia. Gemini 3.1 Flash-Lite (preview) es la opción más rápida y es ideal para lotes muy grandes donde el rendimiento es lo más importante.

Los modelos en vista previa están sujetos a cambios por parte de Google. i1n realiza un seguimiento de los nuevos lanzamientos de Gemini y los expone en el panel a medida que están disponibles; no se requiere ninguna enmienda al contrato para cambiar de modelo.

Configuración

Paso 1 — Genere una clave de API de Gemini. Inicie sesión en Google AI Studio (aistudio.google.com), abra API keys y cree una nueva clave vinculada al proyecto que desea utilizar para la facturación.

Paso 2 — Agregue la clave a i1n. Desde el panel, abra la configuración de su organización, navegue a la sección BYOK, pegue la clave API y guarde. La clave se cifra en reposo inmediatamente después de enviarla.

Paso 3 — Elija su modelo predeterminado. Seleccione uno de los modelos Gemini disponibles (consulte Modelos disponibles más arriba). La selección entrará en vigencia para todos los trabajos de traducción posteriores en la CLI, el servidor MCP y el panel de control.

Paso 4 — Verificar. Ejecute i1n push --translate con un conjunto pequeño de claves y confirme que el trabajo se complete. La vista de uso del panel muestra si cada traducción fue procesada a través de BYOK o mediante la ruta de inferencia predeterminada de i1n.

Para rotar la clave, reemplázala en el panel de control en cualquier momento; los trabajos en curso seguirán utilizando la clave anterior hasta que finalicen. Para desactivar BYOK por completo, elimina la clave del panel; las traducciones futuras volverán automáticamente a la ruta de inferencia predeterminada de i1n.

Relacionado