Usa tu propia clave (BYOK)
Guarda las claves de API propias de tu organización para los proveedores de modelos en la página BYOK, dentro de Configuración. Las solicitudes de localización que utilicen los modelos de ese proveedor se enviarán directamente a él con tu clave, y el proveedor te las facturará. Disponible con el plan Enterprise.
Proveedores compatibles: Anthropic, OpenAI, Google y Mistral AI.
Qué solicitudes usan tu clave#
Solo la localización usa tu clave. Todo lo demás sigue usando la clave de Lingo.dev.
| Solicitud | Clave |
|---|---|
| Localización: la API localize, las tareas de localización, el Playground y cada paso de localización que ejecuta un motor | Tu clave, si tienes una para el proveedor de ese modelo |
| Control de calidad | Clave de Lingo.dev |
| Evaluadores de IA | Clave de Lingo.dev |
| Sugerencias del motor | Clave de Lingo.dev |
Facturación#
Cuando se procesa una solicitud con tu clave, el proveedor te factura los tokens utilizados.
Quién puede gestionar las claves#
El acceso a la página BYOK está sujeto a dos condiciones:
- Derecho de acceso: la función BYOK debe estar habilitada para la organización (plan Enterprise). La página siempre aparece en Configuración. Sin este derecho de acceso, 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, se necesita el permiso Gestionar configuración (
org:manage_settings) en el rol del miembro. 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. No se pueden cambiar las claves con una clave de API de la organización. Para hacerlo, inicia sesión con una cuenta de usuario.
Añadir una clave#
- Abre Configuración → BYOK.
- Haz clic en Añadir clave junto al proveedor.
- Pega la clave de API y guarda los cambios.
Lingo.dev comprueba 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 los cuatro últimos caracteres y cuándo se actualizó. Para cambiarla, usa Sustituir y pega una nueva clave.
Usar los modelos de un proveedor#
Tu clave se usa cuando un motor llama a un modelo de ese proveedor. Para ejecutar un modelo del proveedor con tu clave, selecciona ese modelo en la configuración de modelos del motor.
| Situación | Qué ocurre |
|---|---|
| Tienes una clave para el proveedor del modelo y está activada | La solicitud usa tu clave |
| No tienes ninguna clave para ese proveedor | La solicitud usa la clave de Lingo.dev y tus créditos, como antes |
| La clave está desactivada | La solicitud usa la clave de Lingo.dev y tus créditos |
| El proveedor rechaza el uso del modelo con tu clave | La solicitud se reintenta con la clave de Lingo.dev y tus créditos |
No tener una clave o tenerla desactivada nunca detiene la localización. Sin embargo, si el proveedor rechaza el modelo después de haber empezado a responder, la solicitud puede fallar. Para evitarlo, concede a tu clave acceso al modelo o elige otro.
Cuando se rechaza tu clave#
Estos errores detienen la solicitud. No se pasa a usar la clave de Lingo.dev ni el 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 limita la frecuencia de las solicitudes con tu clave | Vuelve a intentarlo en unos minutos o aumenta los límites de frecuencia de la clave con el proveedor |
| Tu cuenta del proveedor ha agotado los créditos o la 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 Configuración → BYOK y vuelve a intentarlo. |
| Lingo.dev no puede leer la clave guardada | Vuelve a guardar la clave en Configuración → BYOK y vuelve a intentarlo. |
Son los límites de tu propia cuenta, por lo que desviar el tráfico a la clave 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 los modelos de ese proveedor usan la clave de Lingo.dev y tus créditos hasta que vuelvas a activarla.
Si tu plan deja de incluir el uso de claves propias, la clave guardada muestra Guardada, sin usar. Los modelos de ese proveedor usan la clave de Lingo.dev y tus créditos. La clave se conserva hasta que la elimines.
Eliminar una clave#
Haz clic en Eliminar clave. La clave se elimina de Lingo.dev y los modelos de ese proveedor vuelven a usar la clave de Lingo.dev y tus créditos.
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í.