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:
- 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.
- 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 #
- Abre Ajustes → BYOK.
- Haz clic en Añadir clave junto al proveedor.
- 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ón | Qué ocurre |
|---|---|
| Tienes una clave del proveedor del modelo, está activada y el proveedor permite acceder al modelo con ella | La solicitud usa tu clave |
| No tienes una clave de ese proveedor | La localización con un modelo del catálogo usa tus créditos de Lingo.dev |
| La clave está desactivada | La 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á desactivada | La 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 clave | Si 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ón | Qué hacer |
|---|---|
| El proveedor aplica un límite de frecuencia a las solicitudes de tu clave | Vuelve 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 cuota | Añade créditos o aumenta la cuota con el proveedor y vuelve a intentarlo |
| El proveedor rechaza tu clave, por ejemplo, porque se ha revocado | Sustituye la clave en Ajustes → BYOK y vuelve a intentarlo |
| Lingo.dev no puede leer la clave almacenada | Guarda 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í.