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. Agrega la clave de tu organización en la página BYOK de Configuración y luego elige un modelo para la localización. Las solicitudes a los modelos de ese proveedor usan tu clave y el proveedor te factura directamente por los tokens. Disponible en 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 elijas un modelo.

Facturación #

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

Quién puede administrar las claves #

El acceso a la página BYOK depende de dos requisitos:

  1. Derecho: la función BYOK debe estar habilitada para la organización (plan Enterprise). La página siempre aparece en Configuración. Si no tienes este derecho, muestra "Tu plan no permite usar tus propias claves de proveedor" y no puedes guardar una clave.
  2. Permiso: para agregar, reemplazar, activar, desactivar o eliminar una clave, el rol del miembro debe tener el permiso Administrar configuración (org:manage_settings). Sin RBAC, todos los miembros tienen el rol de Propietario y cuentan con este permiso.

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

Agregar una clave #

  1. Abre Configuración → BYOK.
  2. Haz clic en Agregar clave junto al proveedor.
  3. 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 no 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 una solicitud de localización llama a un modelo de ese proveedor. Para usarla en los pasos de localización de un motor, elige un modelo de ese proveedor en la configuración de modelos del motor.

SituaciónQué sucede
Tienes una clave del proveedor del modelo, está activada y el proveedor permite usar el modelo con ellaLa solicitud usa tu clave
No tienes una clave para 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 usarlo
El proveedor no permite usar el modelo con tu claveSi el modelo está en el catálogo, se reintenta con tus créditos de Lingo.dev; si está fuera del catálogo, falla

Etiqueta BYOK

Tu clave solo se usa cuando el proveedor ofrece el modelo con el ID exacto configurado en tu motor. Los selectores de modelos y la configuración de modelos de tu motor marcan con BYOK los modelos que puedes usar con tu clave. Un modelo guardado con la etiqueta No BYOK no se puede usar 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 Requiere una clave de Mistral AI no está en el catálogo de modelos de Lingo.dev y solo se puede usar con tu clave de Mistral AI, pero no la has agregado o está desactivada. Agrega 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 que puedes usar con tu clave de Mistral AI, pero 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, una sola vez por modelo, con el ID que les asigna Mistral AI. Un modelo guardado con uno de sus alias, como mistralai/zai-glm-latest, también usa tu clave.

Estos modelos solo se pueden usar con tu clave, ya que la clave de Lingo.dev no permite usarlos. 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 agregan 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 limita la frecuencia de las solicitudes de tu claveVuelve a intentarlo en unos minutos o solicita al proveedor que aumente los límites de frecuencia de solicitudes de la clave
Tu cuenta del proveedor se quedó sin créditos o agotó su cuotaAgrega créditos o aumenta la cuota con el proveedor y vuelve a intentarlo
El proveedor rechaza tu clave, por ejemplo, porque fue revocadaReemplaza la clave en Configuración → BYOK y vuelve a intentarlo
Lingo.dev no puede leer la clave almacenadaGuarda de nuevo la clave en Configuración → BYOK y vuelve a intentarlo

Se trata de los límites de tu clave y de tu propia cuenta, por lo que reintentar 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 se ejecutan mientras la clave está desactivada.

Si tu plan ya no permite usar tus propias claves, las claves almacenadas muestran el estado Almacenada, sin uso. 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 se ejecutan. 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 ejecutarse.

Revócala con 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í.