Usa tu propia clave (BYOK)
Guarda las claves de API propias de tu organización para proveedores de modelos en la página BYOK, en Configuración. Las solicitudes de localización para los modelos de ese proveedor se envían directamente al proveedor con tu clave, y este te las factura. Disponible en 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, los trabajos 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 una solicitud se procesa con tu clave, el proveedor te cobra por los tokens utilizados.
Quién puede administrar las claves#
El acceso a la página BYOK depende de dos requisitos:
- Derecho: la función BYOK debe estar habilitada para la organización (plan Enterprise). La página siempre aparece en Configuración. Sin este derecho, muestra el mensaje "Tu plan no permite usar tus propias claves de proveedores" y no puedes guardar una clave.
- Permiso: para agregar, reemplazar, activar, desactivar o eliminar una clave, se necesita el permiso Administrar configuración (
org:manage_settings) en el rol del miembro. Sin RBAC, todos los miembros tienen el rol de Propietario y cuentan con ese permiso.
Todos los miembros pueden ver qué proveedores tienen una clave y si está en uso. Las claves no se pueden cambiar con una clave de API de la organización. Para hacerlo, inicia sesión con tu cuenta de usuario.
Agregar una clave#
- Abre Configuración → BYOK.
- Haz clic en Agregar clave junto al proveedor.
- Pega la clave de API y guarda.
Lingo.dev verifica la clave con el proveedor cuando la guardas. Si el proveedor no la acepta, no se guarda. Revísala en tu cuenta del proveedor y vuelve a pegarla.
Visibilidad de la clave
Una vez guardada, la clave nunca vuelve a mostrarse. La página solo muestra los últimos cuatro caracteres y cuándo se actualizó. Para cambiarla, usa Reemplazar y pega una clave nueva.
Usar los modelos de un proveedor#
Tu clave se usa cuando un motor llama a un modelo de ese proveedor. Para ejecutar un modelo de un proveedor con tu clave, selecciona ese modelo en la configuración de modelos del motor.
| Situación | Qué sucede |
|---|---|
| Tienes una clave para el proveedor del modelo y está activada | La solicitud usa tu clave |
| No tienes una 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 no permite usar el modelo con tu clave | La solicitud se vuelve a intentar con la clave de Lingo.dev y tus créditos |
La localización nunca se detiene por una clave faltante o desactivada. Sin embargo, si el proveedor rechaza el uso del modelo cuando este ya comenzó a responder, la solicitud puede fallar. Para evitarlo, habilita el acceso al modelo para tu clave o elige otro modelo.
Cuando se rechaza tu clave#
Estos errores detienen la solicitud. No se pasa a la clave de Lingo.dev ni 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 a la frecuencia de solicitudes de tu clave | Vuelve a intentarlo en unos minutos o solicita al proveedor que aumente los límites de frecuencia de tu clave |
| Tu cuenta del proveedor se quedó sin créditos o agotó su cuota | Agrega créditos o aumenta la cuota con el proveedor y vuelve a intentarlo |
| El proveedor rechaza tu clave, por ejemplo, porque fue revocada | Reemplaza 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 e inténtalo de nuevo. |
Se trata de tus propios límites y 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 ya no permite usar tus propias claves, la clave guardada muestra el estado 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í.