Usa tu propia clave (BYOK)

Guarda las claves de Anthropic, OpenAI, Google y Mistral AI de tu organización para que las solicitudes de localización usen tu clave y el proveedor te facture directamente.

Usa tu propia clave de API de un proveedor de modelos para la localización. Añade la clave de tu organización en la página BYOK de Ajustes y, después, elige un modelo para la localización. Las solicitudes que utilicen modelos de ese proveedor usarán tu clave y el proveedor te facturará directamente los tokens. Disponible con el plan Enterprise.

Proveedores compatibles: Anthropic, OpenAI, Google y Mistral AI.

Localización con tu clave #

Otras funciones, como los evaluadores de IA y las sugerencias del motor, no requieren una clave de proveedor ni que selecciones un modelo.

Facturación #

Cuando la localización usa tu clave, el proveedor te factura los tokens del modelo y Lingo.dev no te cobra el coste del modelo. La tarifa de infraestructura de Lingo.dev por el contenido localizado sigue aplicándose. Si la localización no usa tu clave, el coste del modelo se cubre con tus créditos de Lingo.dev.

Quién puede gestionar las claves #

El uso de la página BYOK está sujeto a dos condiciones:

  1. Disponibilidad en el plan: la función BYOK debe estar habilitada para la organización (plan Enterprise). La página siempre aparece en Ajustes. Si la función no está habilitada, muestra «Tu plan no incluye el uso de claves propias de proveedores» y no puedes guardar ninguna clave.
  2. Permiso: para añadir, sustituir, activar, desactivar o eliminar una clave, el rol del miembro debe tener el permiso Gestionar ajustes (org:manage_settings). Sin RBAC, todos los miembros tienen el rol de Propietario y disponen de este permiso.

Todos los miembros pueden ver qué proveedores tienen una clave y si está en uso. Las claves no se pueden modificar con una clave de API de la organización. Para hacerlo, inicia sesión con una cuenta de usuario.

Añadir una clave #

  1. Abre Ajustes → BYOK.
  2. Haz clic en Añadir clave junto al proveedor.
  3. Pega la clave de API y guárdala.

Lingo.dev valida la clave con el proveedor cuando la guardas. Si el proveedor no la acepta, no se guarda. Compruébala en tu cuenta del proveedor y vuelve a pegarla.

Visibilidad de la clave

Una vez guardada, la clave no vuelve a mostrarse. La página solo muestra sus últimos cuatro caracteres y cuándo se actualizó. Para cambiarla, usa Sustituir y pega una clave nueva.

Usar los modelos de un proveedor #

Tu clave se usa cuando una solicitud de localización llama a un modelo de ese proveedor. Para usarla en los pasos de localización de un motor, selecciona un modelo de ese proveedor en la configuración de modelos del motor.

SituaciónQué ocurre
Tienes una clave del proveedor del modelo, está activada y el proveedor permite acceder al modelo con ellaLa solicitud usa tu clave
No tienes una clave de ese proveedorLa localización con un modelo del catálogo usa tus créditos de Lingo.dev
La clave está desactivadaLa localización con un modelo del catálogo usa tus créditos de Lingo.dev
El modelo no está en el catálogo de modelos de Lingo.dev y no tienes una clave de su proveedor o está desactivadaLa localización con ese modelo falla porque la clave de Lingo.dev no permite acceder a él
El proveedor no permite acceder al modelo con tu claveSi el modelo está en el catálogo, la solicitud se reintenta con tus créditos de Lingo.dev; si está fuera del catálogo, falla

Etiqueta BYOK

Tu clave solo se usa si el proveedor permite acceder al modelo con el ID exacto configurado en tu motor. Los selectores de modelos y la configuración de modelos del motor identifican con BYOK los modelos disponibles con tu clave. Un modelo guardado con la etiqueta No usa BYOK no está disponible con tu clave, por lo que la localización con ese modelo usa tus créditos de Lingo.dev. Un modelo guardado con la etiqueta Necesita una clave de Mistral AI no está en el catálogo de modelos de Lingo.dev y solo funciona con tu clave de Mistral AI, pero esa clave no se ha añadido o está desactivada. Añade o activa la clave, o elige otro modelo.

No tener una clave o tenerla desactivada nunca impide la localización con un modelo del catálogo.

Modelos fuera del catálogo #

Los selectores de modelos también ofrecen modelos de chat disponibles con tu clave de Mistral AI que no están en el catálogo de modelos de Lingo.dev, como mistralai/zai-glm-5-3. Llevan la etiqueta BYOK y aparecen como provider/model, con una sola entrada por modelo y con el ID que le asigna Mistral AI. Un modelo guardado con uno de sus alias, como mistralai/zai-glm-latest, también usa tu clave.

Estos modelos solo funcionan con tu clave porque la clave de Lingo.dev no permite acceder a ellos. Por ahora, solo la lista de modelos de Mistral AI indica cuáles son modelos de chat, por lo que las claves de otros proveedores no añaden modelos fuera del catálogo.

Cuando se rechaza tu clave #

Estos errores detienen la solicitud de localización. No se reintenta con tus créditos de Lingo.dev ni se pasa al siguiente modelo de la configuración de modelos del motor. El mensaje de error indica el proveedor y qué debes corregir.

SituaciónQué hacer
El proveedor aplica un límite de frecuencia a las solicitudes de tu claveVuelve a intentarlo en unos minutos o solicita al proveedor que aumente los límites de frecuencia de la clave
Tu cuenta del proveedor se ha quedado sin créditos o ha agotado su cuotaAñade créditos o aumenta la cuota con el proveedor y vuelve a intentarlo
El proveedor rechaza tu clave, por ejemplo, porque se ha revocadoSustituye la clave en Ajustes → BYOK y vuelve a intentarlo
Lingo.dev no puede leer la clave almacenadaGuarda de nuevo la clave en Ajustes → BYOK y vuelve a intentarlo

Se trata de los límites de tu clave y de tu cuenta, por lo que reintentar la solicitud con créditos de Lingo.dev te ocultaría el problema.

Desactivar una clave #

Desactiva la clave para dejar de usarla sin eliminarla. La página muestra Desactivada y la localización con los modelos del catálogo de ese proveedor usa tus créditos de Lingo.dev hasta que vuelvas a activarla. Los modelos fuera del catálogo no funcionan mientras la clave está desactivada.

Si tu plan deja de incluir el uso de claves propias, la clave almacenada aparece como Almacenada, sin usar. La localización con los modelos del catálogo de ese proveedor usa tus créditos de Lingo.dev y los modelos fuera del catálogo no funcionan. La clave se conserva hasta que la elimines.

Eliminar una clave #

Haz clic en Eliminar clave. La clave se elimina de Lingo.dev. La localización con los modelos del catálogo de ese proveedor vuelve a usar tus créditos de Lingo.dev y los modelos fuera del catálogo dejan de funcionar.

Revócala en el proveedor

Eliminar una clave de Lingo.dev no la revoca. La clave sigue siendo válida en el proveedor hasta que la revoques allí.