Suscripciones de IA y claves API: guía de conexión

Primero, el vocabulario

No siempre necesitas una clave API para escribir mazos y estudiar. Se necesita para generar con tu propia cuenta de IA.

1. Suscripción, API y pase web

Una API permite que un programa solicite trabajo a una IA. La clave es una credencial secreta que autoriza el uso de tu cuenta. No es el código de acceso por correo, la clave de recuperación de Quiz Notebook ni la contraseña del chat.

La facturación del chat y de la API es independiente, aunque uses el mismo correo. No necesitas contratar primero un chat de pago para utilizar una API; revisa la facturación de la cuenta API.

2. Elige cómo trabajar

Puedes trabajar manualmente en tu chat de IA habitual, revisar el resultado e importarlo en un formato compatible. Es un proceso distinto de esta conexión API.

Con BYOK gestionas tu clave, modelo y gasto. Esta conexión admite OpenAI y Anthropic directamente. Las credenciales de Gemini, NotebookLM, Azure o Bedrock no sirven en estos campos.

Para encargar un mazo terminado no envíes tu clave. El servicio incluye evaluación previa, acuerdo de alcance, revisión y entrega. Consulta la página del servicio para saber si ya admite pedidos de pago.

3. Antes de empezar

Prepara una cuenta API con facturación, un ID de modelo disponible y una muestra breve que tengas derecho a transmitir. En cuentas de empresa o centro educativo, comprueba la autorización para conectar servicios externos.

La aplicación exige acceso por correo, un pase válido y un dispositivo registrado y activo en los ajustes de cuenta. Crear una clave no habilita una función todavía cerrada.

No escribas claves en esta guía ni las envíes por formulario o correo. Usa únicamente el campo de contraseña de la aplicación web oficial.

4. Crear una clave de OpenAI

1. Accede a OpenAI API Platform, no a los ajustes de suscripción de ChatGPT.
2. Crea o selecciona un proyecto dedicado a Quiz Notebook en tu organización para separar consumo y revocación.
3. Revisa API Billing, método de pago y créditos. Desactiva Auto-reload si no quieres compras automáticas y guarda el cambio.
4. En API Keys del proyecto crea una nueva clave secreta, ponle un nombre reconocible y guárdala en un gestor de contraseñas seguro.
5. Limita los permisos cuando sea posible. Esta conexión necesita crear solicitudes a Responses API; Read Only no basta. No uses una clave de administración.
6. Busca el ID exacto del modelo API en la documentación oficial y confirma el acceso de tu proyecto. No uses el nombre del plan ni la etiqueta del chat.

Si pierdes la clave, crea otra y revoca la anterior. También deben ser válidos la facturación y los permisos de proyecto y modelo.

5. Crear una clave de Claude / Anthropic

1. Accede a Claude Console, separado de la suscripción Claude Pro o Max.
2. Selecciona organización y espacio de trabajo. Configura API Billing y revisa recargas y controles de gasto disponibles.
3. Crea una clave de inferencia en API Keys. Usa una clave para un solo espacio de trabajo, no una de administrador ni de otra nube.
4. Comprueba nombre, permisos y caducidad. Guarda el secreto y recuerda qué espacio de trabajo debes consultar para el consumo.
5. Consulta un ID de modelo disponible en la documentación y selecciona Anthropic en Quiz Notebook.

Pagar una suscripción a Claude no sustituye el saldo ni la configuración de facturación API de Console.

6. Conectar en Quiz Notebook

1. Inicia sesión en la aplicación oficial y comprueba el pase y el dispositivo activo en los ajustes.
2. Elige un mazo; empieza con una o dos preguntas y respuestas breves escritas por ti.
3. Abre ‘내 API로 AI 후보 만들기’ (Crear candidatos con mi API), debajo del mazo seleccionado. No está dentro de los ajustes de cuenta.
4. Selecciona OpenAI o Anthropic, introduce el ID exacto del modelo y pega la clave en ‘본인 API 키’ (Tu clave API), sin espacios ni saltos de línea adicionales.
5. Lee y acepta el aviso de transmisión y coste separado. Se envía el texto de preguntas y respuestas del mazo, no se leen automáticamente imágenes ni adjuntos.
6. Pulsa una vez ‘별도 후보 덱 만들기’ (Crear un mazo de candidatos separado) y espera. Introducir la clave por sí solo no llama a la IA.
7. Comprueba exactitud, explicaciones y derechos del nuevo mazo frente a la fuente. No se fusiona automáticamente con el original ni recibe la revisión del servicio de producción.
8. Consulta Usage y Billing del proveedor antes de aumentar el volumen.

7. Destino de la clave y los materiales

La ruta es navegador → servidor de Quiz Notebook → proveedor elegido → navegador. El servidor maneja temporalmente la clave en memoria; no es una conexión exclusiva entre navegador y proveedor.

La implementación actual no guarda la clave en la base de datos de cuenta ni en el almacenamiento persistente del navegador, ni registra intencionadamente el cuerpo de las solicitudes. Recargar o cerrar sesión borra la clave de la pantalla. Esto no garantiza retención cero por parte del proveedor de IA.

La sincronización privada cifrada es distinta de enviar texto legible a la IA. Elimina nombres, contactos y expedientes innecesarios, y verifica el permiso de uso y transmisión.

8. Controlar el coste

El coste depende del modelo, tokens de entrada y salida y número de llamadas. Un token no equivale a un carácter. Fuentes extensas, respuestas largas y repeticiones pueden aumentar el gasto.

Calcula tokens de entrada × tarifa de entrada + tokens de salida × tarifa de salida con las unidades de la tarifa oficial. Revisa caché, razonamiento, impuestos y cambio de moneda. El pase web se paga aparte.

Las alertas de OpenAI no detienen el tráfico. En Limits, comprueba y guarda ‘Enforce a hard limit’ si quieres un límite aplicado. Puede haber un pequeño exceso por retraso de aplicación. El límite de recarga automática controla compras de crédito, no el gasto API.

En Claude revisa Usage y Billing de la organización o espacio de trabajo. Empieza con poco y comprueba alertas, límites y recargas por separado.

9. Desconectar, cambiar o cancelar

1. Pulsa ‘입력한 API 키 지우기’ (Borrar la clave introducida) para borrar la clave y el consentimiento de la pantalla. No cancela una solicitud en curso.
2. Para impedir usos futuros en otros lugares, revoca o elimina la clave en API Keys del proveedor. Vaciar el campo no la revoca.
3. Para reconectar usa una clave nueva. Si sospechas exposición, revoca primero la anterior y revisa Usage y Billing.
4. Gestiona por separado la suscripción al chat, las recargas API y el pase Quiz Notebook. Cancelar uno no cancela los demás.

Al pedir ayuda, indica hora, proveedor, ID del modelo y una captura con secretos ocultos. Nunca envíes la clave completa.

10. Resolver problemas

Botón desactivado: comprueba disponibilidad, sesión, pase, consentimiento y solicitudes en curso. Ante un error de dispositivo, revisa registro y activación.

Error de clave, modelo o permiso: revisa proveedor, espacios, caducidad, revocación, permisos e ID exacto. El pago del chat no añade saldo API.

Límite o saturación: revisa saldo, velocidad y límites de gasto. Los créditos nuevos pueden tardar en aparecer; no compres repetidamente sin identificar la causa.

Tiempo agotado o formato incorrecto: no hay reintento automático. El proveedor puede haber realizado trabajo facturable. Consulta Usage antes de repetir con menos texto.

Contenido incorrecto: conectar correctamente no valida las respuestas. Corrige o descarta candidatos sin fundamento.

11. Compartir, derechos y organizaciones

No compartas claves con amigos o estudiantes: el consumo puede cobrarse a la misma cuenta. La implantación institucional requiere acuerdos sobre propiedad, permisos y gasto. No adjuntes claves ni datos reales de alumnos a una consulta.

Recomendamos usar los resultados para estudio personal. Comprueba derechos antes de enviar libros o apuntes ajenos a una IA externa, publicar o vender resultados. La privacidad no elimina automáticamente los problemas de derechos de autor.

La clave API autoriza llamadas de IA; el código por correo permite iniciar sesión; la clave de recuperación abre mazos cifrados. No son intercambiables.

12. Preguntas frecuentes

¿Pegar una clave genera un cobro? No se envía una solicitud solo por pegarla. La generación puede generar costes cuando el proveedor la procesa.

¿El resultado será igual al del chat? Modelos, instrucciones, ajustes y herramientas pueden variar. La búsqueda y los adjuntos del chat no se incluyen automáticamente.

¿Hay que volver a introducirla? Sí, después de recargar o cerrar sesión, porque no se guarda permanentemente. Mantener la sesión es otra cosa.

¿Las aplicaciones instaladas tienen el mismo menú? Esta guía describe la web. Consulta el manual de cada versión de tableta o escritorio para conocer su flujo y disponibilidad.