Documentación

Visibilidad en IA: tus propias claves de API

Consigue una clave de API para cada modelo de IA y añádela a CrunchJunkie, o ahórrate la configuración con Managed AI.

Dos formas de alimentar la Visibilidad en IA

La Visibilidad en IA consulta cada modelo de IA en tu nombre, y para ello necesita una clave de API de ese modelo. Tienes dos opciones. Con Managed AI, CrunchJunkie aporta las claves: ejecutamos los modelos con nuestras propias claves de plataforma, medidos por comprobación en un plan mensual de Managed AI (desde 25 €/mes, con un exceso de 0,05 €/comprobación), sin nada que configurar. O puedes traer tu propia clave de API para cada modelo y pagar directamente al proveedor. Puedes combinar ambas y cambiar cuando quieras: por ejemplo, usar tu propia clave de OpenAI y Managed AI para el resto. En ambos casos las claves se guardan cifradas (AES-256-GCM). Ejecutan tus escaneos, y una clave de OpenAI, Claude o Gemini también alimenta las funciones de IA de Crunch (resúmenes de informes, Ask Crunch, briefings de contenido) salvo que añadas una clave de asistente aparte; las claves de Grok y DeepSeek ejecutan solo escaneos. En Managed AI, esas funciones se ejecutan en Claude con la clave de Anthropic de CrunchJunkie. Las secciones siguientes muestran cómo conseguir tu propia clave en cada proveedor.

OpenAI: ChatGPT

Crea una cuenta en platform.openai.com. IMPORTANTE: el acceso a la API de OpenAI es de pago por uso y se factura APARTE de cualquier suscripción a ChatGPT; un plan ChatGPT Plus, Team o Business NO incluye acceso a la API, y su inicio de sesión o sus claves no funcionarán aquí. Es el error más común. Por eso, primero, en Settings → Billing de platform.openai.com, añade un método de pago y un poco de crédito. Después abre platform.openai.com/api-keys, haz clic en «Create new secret key», ponle el nombre «CrunchJunkie» y cópiala: solo se muestra una vez. Pégala en CrunchJunkie. Cuando conectas una clave, CrunchJunkie hace una prueba real y rápida de cada función que alimenta la clave y rechaza al instante una clave sin créditos ni facturación, para que nunca creas que estás configurado cuando no lo estás. Los ajustes que necesita una clave y lo que cuesta la prueba están en la sección siguiente. Una clave válida alimenta tanto el modelo de visibilidad de ChatGPT (actualmente GPT-5.6 Luna con búsqueda web) como la propia IA de CrunchJunkie (resúmenes de informes y el asistente Crunch, en GPT-5.6 Terra). Si prefieres no configurar la facturación de OpenAI, una clave de Claude o de Gemini funciona igual de bien para la IA de CrunchJunkie, o usa Managed AI.

Usar tu propia clave de OpenAI

Una clave de OpenAI ejecuta hasta tres cosas aquí, cada una en su propio endpoint y modelo: los escaneos de Visibilidad en IA (la Responses API, modelo gpt-5.6-luna), la IA de CrunchJunkie (Chat Completions, modelo gpt-5.6-terra) y la transcripción de voz (el endpoint de audio, modelo whisper-1). Al conectar la clave, CrunchJunkie prueba cada una de ellas y muestra el resultado por función. La clave se guarda para las funciones que funcionan, y una función que OpenAI rechaza muestra el motivo de OpenAI y dónde corregirlo. Cuatro ajustes deciden el resultado. Permisos. Funciona una clave cuyos permisos están en All. Una clave Restricted necesita Model capabilities: Request, que cubre los tres endpoints a los que llaman la comprobación y las funciones: Responses (Write) para los escaneos, Chat completions para la IA de CrunchJunkie y Audio para la transcripción de voz. Pon primero Model capabilities en Request y después desactiva lo que no necesites, porque marcar solo un subelemento ha llegado a dejar fuera el propio permiso de petición. Puedes cambiar los permisos de una clave existente en platform.openai.com → API keys → edita la clave → Permissions; no hace falta una clave nueva. Cuando OpenAI rechaza por un permiso que falta, CrunchJunkie nombra el que indica OpenAI, por ejemplo Responses: Write. Si la clave está en All y OpenAI sigue informando de un permiso que falta, el propietario de la clave necesita un rol en el proyecto que pueda hacer peticiones (Member u Owner). Crédito y facturación. OpenAI factura el uso de la API aparte de ChatGPT (ver arriba). La organización necesita crédito o un método de pago en Settings → Billing, y un límite de gasto que fijes para la organización o el proyecto detiene la clave cuando se alcanza. Modelos permitidos. Si el proyecto de la clave limita qué modelos puede usar (Settings → tu proyecto → Limits → Model usage), permite gpt-5.6-luna para los escaneos y gpt-5.6-terra para la IA de CrunchJunkie. OpenAI deja usar algunos modelos solo a una organización verificada; si lo indica, verifica en Settings → Organization → General → Verify Organization. OpenAI dice que el acceso puede tardar hasta 15 minutos en llegar después. Sin lista de IP permitidas. Las direcciones de nuestros servidores cambian, así que un proyecto u organización que acepta peticiones solo de direcciones IP listadas rechaza todas las que enviamos. Usa una clave de un proyecto sin lista de IP permitidas. Lo que cuesta la comprobación. Una petición diminuta por función, facturada por OpenAI a la cuenta de la clave: una petición Responses a gpt-5.6-luna limitada a 16 tokens de salida y sin búsqueda web, una petición Chat Completions a gpt-5.6-terra, también limitada a 16 tokens de salida, y, cuando la clave también ejecuta la IA de CrunchJunkie, medio segundo de audio en silencio para whisper-1. En conjunto es bastante menos de una décima de céntimo de dólar estadounidense. Las claves de los otros proveedores también se comprueban con una generación real diminuta, y un rechazo nombra el motivo del proveedor. Las causas de Gemini y cómo corregirlas están en Google: Gemini. Una clave de Anthropic necesita crédito en Plan & Billing de console.anthropic.com, y un límite de gasto mensual que fijes allí la detiene cuando se alcanza. Perplexity da la misma respuesta para una clave no válida y para una cuenta sin crédito, así que revisa ambas cosas cuando rechace una clave.

Google: Gemini

Ve a aistudio.google.com e inicia sesión con una cuenta de Google. Abre aistudio.google.com/apikey («Get API key») y haz clic en «Create API key». Gemini tiene un nivel gratuito con el que puedes empezar; para límites de frecuencia más altos y un grounding de búsqueda web fiable, vincula un proyecto de Google Cloud que tenga la facturación activada. Copia la clave y pégala en CrunchJunkie. Esto alimenta el modelo Gemini (búsqueda web). Cuando conectas una clave de Gemini, CrunchJunkie hace una generación real diminuta con el modelo con el que escanea y, si Google la rechaza, te dice el motivo real de Google en lugar de una suposición. Una clave puede rechazarse por razones que nada tienen que ver con la clave en sí, así que una clave recién creada no es una garantía. Las habituales: la clave se cortó al copiarla; el proyecto de Google Cloud de la clave tiene una cuenta de facturación desactivada, cerrada o no del todo configurada (BILLING_DISABLED); el crédito Prepay de esa cuenta de facturación está a 0 $ (HTTP 402, que detiene todas las claves de la cuenta); la Generative Language API está desactivada en el proyecto (SERVICE_DISABLED); la clave tiene una restricción de aplicación (sitios web, direcciones IP o apps) que bloquea las peticiones de nuestros servidores, o restricciones de API que dejan fuera la Generative Language API; Google rechaza la petición con FAILED_PRECONDITION, que Google vincula a la facturación; o Google ha bloqueado todo el proyecto («Your project has been denied access»). Para problemas de facturación, termina la cuenta de facturación en Google AI Studio → Billing, o desvincula el proyecto de ella (Google dice que entonces el proyecto vuelve al nivel gratuito), o crea la clave en un proyecto sin facturación. Para un proyecto bloqueado, ábrelo en Google AI Studio y sigue su aviso; una clave nueva en la misma cuenta de Google suele obtener la misma respuesta. Para una restricción de clave, elimina o relaja solo la restricción de aplicación (direcciones IP, sitios web o apps), ya que las direcciones de nuestros servidores no son fijas, y mantén la restricción de API de la clave («Restrict to Gemini API only» en Google AI Studio → API Keys): Google rechaza las claves estándar sin restricciones. Una clave que Google solo limita por frecuencia se guarda, con una nota. Una causa tiene que ver con la antigüedad de la clave: desde septiembre de 2026 Google rechaza las claves «estándar» sin restricciones, y las claves creadas en Google AI Studio desde el 28 de mayo de 2026 son del tipo más reciente. Así que, si Google dice que una clave «no es válida» y se creó antes de esa fecha, restríngela con «Restrict to Gemini API only» en Google AI Studio → API Keys (Google sigue aceptando las claves estándar restringidas), o crea una clave nueva en aistudio.google.com/apikey y sustituye la antigua en Ajustes → Claves de IA y API. No cambia nada más y tu historial se conserva. El mismo motivo aparece en «Requiere atención» en Inicio cuando falla un escaneo con tu clave. Managed AI no se ve afectado.

Perplexity

Inicia sesión en perplexity.ai y abre Settings → API (perplexity.ai/settings/api). Añade un método de pago o compra créditos (el acceso a la API se factura aparte de una suscripción a Perplexity Pro), después genera una clave de API y cópiala. Pégala en CrunchJunkie. Alimenta los escaneos de visibilidad de Perplexity, que se ejecutan a través de la Agent API de Perplexity con su búsqueda web y sus citaciones.

Anthropic: Claude

Crea una cuenta en console.anthropic.com y añade facturación o créditos en Plan & Billing. Después ve a Settings → API Keys (console.anthropic.com/settings/keys), crea una clave y cópiala. Pégala en CrunchJunkie. Esto alimenta el modelo Claude (búsqueda web).

xAI: Grok

Inicia sesión en console.x.ai con tu cuenta de X / xAI, añade facturación, abre después la sección API Keys, crea una clave y cópiala. Pégala en CrunchJunkie. Esto alimenta el modelo Grok (búsqueda web).

DeepSeek

Crea una cuenta en platform.deepseek.com y recarga tu saldo en Billing / Top up. Abre la sección de claves de API, crea una clave y cópiala. Pégala en CrunchJunkie. Esto alimenta el modelo DeepSeek.

SerpAPI: Google AI Overviews y AI Mode

Las respuestas de AI Overviews y AI Mode de Google se leen a través de SerpAPI y no de una API de modelo directa. Regístrate en serpapi.com y encuentra tu clave en el panel (serpapi.com/manage-api-key); hay un cupo mensual gratuito de búsquedas, con planes de pago para mayor volumen. Pega la clave en CrunchJunkie. Esto alimenta los modelos Google AI Overviews y Google AI Mode. Cada comprobación usa una búsqueda de SerpAPI, salvo un AI Overview que Google carga en un segundo paso: SerpAPI lo obtiene con una segunda petición y la factura como una segunda búsqueda, así que esas comprobaciones usan dos. Qué overviews se cargan así solo se sabe cuando se ejecutan. En raras ocasiones, la primera respuesta procede de la caché de SerpAPI con un enlace al overview que ya ha caducado; la comprobación vuelve entonces a preguntar sin caché y usa hasta cuatro búsquedas. La exportación de uso de IA (Ajustes → Facturación) muestra las búsquedas que usó cada comprobación en la columna serpapi_searches, para que el recuento se pueda cotejar con tu panel de SerpAPI.

Dónde añadir tus claves en CrunchJunkie

Todas las claves de API están en un solo lugar: Ajustes → Claves de IA y API. Pega la clave de cada proveedor una sola vez y elige después qué alimenta con los interruptores que tiene al lado: «Usar para seguimiento de visibilidad en IA» (escanear ese modelo) y, para los proveedores que también ejecutan la IA propia de CrunchJunkie (OpenAI, Anthropic, Gemini), «Impulsar CrunchJunkie AI» (resúmenes de informes, detección de anomalías y el asistente Crunch). Así, una sola clave de OpenAI puede mover tanto tus escaneos de visibilidad de ChatGPT como tus resúmenes de informes, sin necesidad de introducirla dos veces. Las claves se cifran en reposo (AES-256-GCM) y se usan solo para los fines que actives; puedes eliminar una en cualquier momento. Cuando conectas una clave, CrunchJunkie hace una generación real diminuta y, si el proveedor la rechaza, dice por qué en tu idioma: la clave no es válida, la cuenta no tiene crédito ni facturación, la clave carece de un permiso, su proyecto no puede usar el modelo, la organización debe verificarse primero, el proveedor solo la limita por frecuencia (la clave se guarda entonces, con una nota) o no se pudo contactar con el proveedor. Cuando la respuesta del proveedor no encaja en ninguna de estas, ves sus propias palabras. Una clave de OpenAI se prueba por función, como se describe en Usar tu propia clave de OpenAI. Si una clave caduca más adelante o se queda sin crédito, se marca en «Requiere atención» en Inicio, para que un escaneo nunca falle en silencio. Conectar una clave no añade su modelo a ningún proyecto: los Motores a monitorizar de cada proyecto deciden qué preguntan sus escaneos. Después de conectar una clave para la visibilidad en IA, la página ofrece añadir su motor a los proyectos que aún no lo siguen; no cambia nada hasta que hagas clic, y no se ejecuta nada hasta el siguiente escaneo de cada proyecto, con tu clave. ¿Prefieres no gestionar claves en absoluto? Activa Managed AI para cualquier modelo y lo ejecutaremos con nuestra clave por un precio mensual fijo.