Estás siguiendo un tutorial de IA, todo va bárbaro, y de golpe te frena una instrucción: "pegá tu API key". ¿Tu qué? Tranquilo: es mucho más simple de lo que suena, y entenderlo te abre la puerta a un montón de herramientas que piden justamente ese dato. En esta guía te explico qué es una API, qué es la key, cómo conseguir la tuya paso a paso, cuánta plata necesitás de verdad y cómo no meter la pata con la seguridad.
Qué es una API (y qué es la key)
Hasta ahora usaste la IA por la puerta de adelante: la app de chat, hecha para personas. Una API es la puerta de servicio: una forma de que los programas hablen directo con el modelo, sin pasar por la pantalla del chat. Cuando una app del clima te muestra el pronóstico, está usando la API de un servicio meteorológico; cuando una herramienta "con IA" te resume textos, por detrás está llamando a la API de OpenAI, Anthropic o Google.
La API key es tu credencial personal para usar esa puerta: una tira larga de letras y números que identifica tu cuenta. Cada vez que un programa la usa, el proveedor sabe que sos vos... y le descuenta a tu saldo. Por eso la analogía justa es: la API key es como tu tarjeta. Quien la tiene, gasta tu crédito.
API key vs suscripción: no son lo mismo
Confusión clásica de principiante: pagar ChatGPT Plus o Claude Pro no te da una API key. Son dos mundos separados:
- Suscripción (Plus, Pro): un abono mensual fijo para usar la app de chat con límites más altos.
- API: una cuenta aparte donde cargás crédito y pagás por uso: cada pedido descuenta según cuánto texto entra y sale, medido en tokens.
Podés tener una sin la otra. Algunas herramientas, como Claude Code, aceptan las dos vías: o iniciás sesión con tu plan pago, o le das una API key con saldo.
Cómo conseguir tu API key de Claude, paso a paso
- Entrá a console.anthropic.com. Es la "consola" para desarrolladores de Anthropic, distinta de claude.ai (aunque uses el mismo email).
- Creá tu cuenta con tu email o con Google, y verificala.
- Cargá crédito. En la sección de facturación (Billing) comprás saldo con tarjeta. La carga mínima ronda los US$5 a la fecha de escribir esto (puede cambiar), y con eso alcanza para muchísimos experimentos.
- Generá la key: andá a "API Keys", tocá "Create Key" y ponele un nombre descriptivo (por ejemplo, "pruebas").
- Copiala YA y guardala en un lugar seguro. Por seguridad, la key completa se muestra una sola vez. Si la perdés no es grave: borrás esa y creás otra.
OpenAI y Google tienen consolas equivalentes con la misma lógica: cuenta, crédito, key. Aprendida una, aprendidas todas.
Cuánto cuesta usarla (la parte que sorprende para bien)
La API se cobra por tokens procesados, con precios por millón de tokens que dependen del modelo (los publica cada proveedor en su página oficial y cambian seguido, así que no te clavo números acá). Lo que importa es el orden de magnitud: los pedidos sueltos cuestan centavos o fracciones de centavo. Resumir un texto, clasificar datos, generar unas descripciones: céntimos. Los US$5 iniciales rinden mucho más de lo que esperás para aprender y probar.
Eso sí: un agente trabajando horas o procesar miles de documentos sí acumula gasto. Casi todas las consolas te muestran el consumo y te dejan poner límites de gasto: activá esos límites el primer día, y navegás tranquilo. Otra costumbre sana: revisá el panel de consumo la primera semana para calibrar cuánto gastan de verdad tus usos; después de ver tres o cuatro números reales, el miedo a "fundirte sin darte cuenta" desaparece solo.
Los errores que te vas a cruzar (y qué significan)
- 401 (unauthorized / no autorizado): la key está mal escrita, incompleta, con espacios de más, o fue borrada. Volvé a copiarla entera o generá una nueva.
- Error de saldo ("credit balance is too low"): te quedaste sin crédito. Se arregla recargando en Billing.
- 429 (rate limit): demasiados pedidos muy seguidos. Esperá unos segundos y reintentá.
Truco de oro para novatos: copiá el mensaje de error exacto y pegáselo a la IA en el chat. Estos errores son tan estándar que casi siempre te dice la causa y la solución al toque.
Seguridad: la regla de la tarjeta
Tu API key gasta tu plata, así que se cuida como una tarjeta:
- No la compartas nunca, ni la pegues en capturas de pantalla, foros o chats públicos.
- Jamás la dejes dentro del código si vas a publicar tu proyecto: los repositorios públicos son escaneados por bots que roban keys en minutos. Va en "variables de entorno", una sección que todas las plataformas tienen para guardar claves aparte del código.
- Si sospechás que se filtró, revocala: la borrás en la consola y creás una nueva. La vieja deja de funcionar al instante.
¿Y si no quiero pagar nada?
Honestidad total: si solo querés chatear con la IA, no necesitás API key; las apps gratuitas te alcanzan y te sobran. La key aparece cuando querés construir cosas propias o usar herramientas que la piden. Y si querés experimentar "por atrás" sin gastar un peso, existe otra vía: correr modelos locales en tu computadora, que no piden key ni saldo. Cada camino tiene su lugar.
Entender estas piezas —qué es un token, qué es una key, cómo se cobra— es lo que separa al que usa la IA de juguete del que la convierte en herramienta. En el libro que te lleva de cero a experto te armamos ese mapa completo en español y sin tecnicismos, desde tu primer prompt hasta estos temas que parecen de programador y no lo son. Tu primera key se crea en cinco minutos; el criterio para usarla bien es lo que te llevás de acá.