Usa tu propia clave API (BYOK)

Antes de empezar

BYOK significa usar una clave API de un proveedor que te pertenece. Neurothread ofrece campos para claves de OpenAI, Anthropic y Google en Ajustes → Claves API. Hace falta un plan de pago. La clave guardada queda asociada a tu cuenta de Neurothread, se almacena cifrada y no vuelve a mostrarse en la lista de ajustes. No tienes que pegarla en un prompt.

También necesitas una cuenta API activa con el proveedor, una clave que pueda realizar peticiones y cualquier límite de uso o facturación configurado allí. Conectar una clave la guarda; no garantiza que el proveedor vaya a aceptarla. No la compartas con un asistente ni con otra persona.

Cuándo te conviene

Usa BYOK si quieres que las peticiones a modelos compatibles se facturen en tu cuenta del proveedor en lugar de consumir créditos de Neurothread. Puede venirte bien si tienes saldo con ese proveedor o quieres gestionar el uso desde allí. No permite usar todos los modelos del catálogo: el modelo debe admitir la clave de ese proveedor y algunos modelos se enrutan o facturan a través de Neurothread.

BYOK no es lo mismo que Apps conectadas. Las claves de proveedor autorizan peticiones a modelos; las conexiones MCP dan acceso a herramientas externas. Para esas integraciones, consulta Apps conectadas.

Pasos

1. Comprueba en la página de precios si tu plan actual permite BYOK.
2. Abre el menú de tu avatar y selecciona Ajustes → Claves API.
3. Elige el proveedor que emitió la clave: OpenAI, Anthropic o Google. Obtén o gestiona la clave en la cuenta de ese proveedor, no en Neurothread.
4. Pulsa Conectar, escribe la clave en el campo protegido y selecciona Guardar. Trátala como una contraseña y evita introducirla en capturas o dispositivos compartidos.
5. Vuelve al selector de modelos y elige uno compatible con ese proveedor. El proveedor guardado aparece como Activa; el secreto no se muestra. Para sustituir la clave, pulsa Editar, introduce la nueva y guarda.
6. Para dejar de usar una clave guardada, pulsa Quitar para ese proveedor y confirma. Se elimina la clave almacenada en Neurothread; si también quieres revocarla en el proveedor, revisa allí la configuración de tu cuenta.

Gestión de claves de proveedor en Ajustes. Datos ficticios de demostración; API simulada, sin claves API reales ni validación del proveedor.

Ejemplo práctico

Supón que tienes una clave API de Google y un plan que incluye BYOK. Guárdala en Google y luego elige un modelo de Google en el selector. Si el proveedor acepta la clave, te facturará esa petición de modelo en tu cuenta de Google API en vez de descontar créditos de Neurothread por esa llamada. Consulta ambas cuentas para distinguir el uso.

Qué ocurre después

La clave permanece guardada en tu cuenta hasta que la sustituyas o la quites; cerrar sesión no obliga a volver a conectarla. Cuando una petición compatible usa esa clave, Neurothread la envía al proveedor. Otras peticiones pueden seguir usando la ruta de la plataforma, según el modelo y la función elegidos. El estado Activa en Ajustes indica que la clave está guardada, no que se haya validado por adelantado ni que sirva para todos los modelos.

Coste y límites

Se aplican las tarifas, condiciones de facturación y controles de uso del proveedor para las peticiones realizadas con tu clave. La generación de modelos compatible no consume créditos de Neurothread por esa llamada, pero la búsqueda web es una función independiente y puede seguir dependiendo de tus créditos de Neurothread. Algunos modelos no admiten BYOK, incluidas ciertas rutas del catálogo, y los modelos con marca Neurothread pueden usar la ruta de la plataforma. Comprueba el selector y los precios vigentes; no des por hecho que una clave cambia el coste o la facturación de todas las funciones.

Solución de problemas

• El proveedor rechaza la petición: comprueba el proveedor, la clave, el acceso a la API y los límites de facturación en la cuenta del proveedor. Si hace falta, sustituye la clave en Ajustes → Claves API.
• La clave figura como Activa, pero falla una petición: Activa significa que hay una clave guardada; no que se haya probado correctamente. Su validez se comprueba al usarla en una petición compatible.
• Un modelo sigue gastando créditos de Neurothread: confirma que admite BYOK con ese proveedor y que tu plan actual lo permite. Una clave guardada no se usa con otros proveedores ni modelos incompatibles.
• No funciona la búsqueda web: BYOK no evita las reglas de créditos independientes de la búsqueda. Revisa tu uso y tu plan.
• Quieres borrar la clave: pulsa Quitar en Ajustes y revócala también en el proveedor si ya no quieres que pueda usarse.

Guías relacionadas

• Modelos y créditos
• Ajustes
• Facturación y suscripciones