Cómo conectar una API de IA (paso a paso)

Una API de IA es la forma en que tu propio programa le habla a un modelo como Claude o GPT: tu código manda una pregunta y recibe la respuesta, sin que tú escribas en una web. Es el paso que separa “uso la IA” de “construyo con la IA”. En esta guía vas a conectar una API de IA desde cero: crear tu clave, instalar el SDK y hacer tu primera llamada.

Elige tu sistema (Windows o Mac) con los botones de arriba y toca cada paso para abrirlo.

Antes de empezar: una API se paga por uso (por tokens), no con mensualidad. Para practicar gastas centavos. Mira los costos en la columna de la derecha.

1 Crea tu cuenta y tu API key

Vamos a usar la API de Claude (Anthropic) como ejemplo. El patrón es igual para OpenAI y otros.

Entra a https://console.anthropic.com y crea tu cuenta.
En el menú de la izquierda abre API Keys.
Aprieta Create Key, ponle un nombre (ej. “pruebas”) y cópiala.

La clave empieza con sk-ant- y solo se muestra una vez. Guárdala en un lugar seguro; si la pierdes, creas otra.

2 Agrega crédito (billing)

La clave no funciona hasta que agregues un método de pago y un poco de crédito.

En la consola abre Settings → Billing.
Agrega una tarjeta y compra un crédito pequeño (con $5 te sobra para practicar).

Es prepago: gastas contra ese saldo. Puedes poner un límite mensual para no llevarte sustos.

3 Instala el SDK

El SDK es una librería que hace fácil hablar con la API. Elige tu lenguaje. Necesitas PowerShellla Terminal abierta.

Con Python (necesitas Python instalado):

pip install anthropic

Con Node.js (necesitas Node.js instalado):

npm install @anthropic-ai/sdk

¿Prefieres OpenAI? Es pip install openai o npm install openai. El resto es casi igual.

4 Guarda tu API key de forma segura

Nunca escribas la clave dentro del código: cualquiera que vea el archivo (o tu repositorio de GitHub) la tendría. En su lugar, guárdala como variable de entorno.

En PowerShell (se guarda para tu usuario):

setx ANTHROPIC_API_KEY "sk-ant-tu-clave-aqui"

Cierra y vuelve a abrir PowerShell para que tome el cambio.

En la Terminal (para la sesión actual):

export ANTHROPIC_API_KEY="sk-ant-tu-clave-aqui"

Para que quede permanente, agrega esa línea a tu archivo ~/.zshrc y ejecuta source ~/.zshrc.

El SDK lee esa variable solo, sin que tú escribas la clave en el código.

5 Haz tu primera llamada

Crea un archivo y pega el ejemplo de tu lenguaje. Cambia solo el texto de la pregunta.

Python (prueba.py):

import anthropic

client = anthropic.Anthropic()  # lee ANTHROPIC_API_KEY del entorno

mensaje = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=300,
    messages=[
        {"role": "user", "content": "Explícame en una frase qué es una API."}
    ],
)

print(mensaje.content[0].text)

Ejecuta:

python prueba.py

Node.js (prueba.mjs):

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // lee ANTHROPIC_API_KEY del entorno

const mensaje = await client.messages.create({
  model: "claude-haiku-4-5",
  max_tokens: 300,
  messages: [
    { role: "user", content: "Explícame en una frase qué es una API." },
  ],
});

console.log(mensaje.content[0].text);

Ejecuta:

node prueba.mjs

Si ves la respuesta impresa en la terminal, ya conectaste tu primera API de IA.

Los nombres de modelo (como claude-haiku-4-5) cambian con el tiempo. Confirma el actual en la documentación oficial.

Si algo sale mal

Problema	Solución
`authentication_error` / 401	La clave no se está leyendo. Revisa la variable de entorno (Paso 4) y reabre la terminal.
`credit balance is too low`	Agrega crédito en Settings → Billing (Paso 2).
`model not found`	El nombre del modelo cambió; confirma el actual en la documentación oficial.
`command not found: pip`/`node`	Falta instalar Python o Node.js (Paso 3).

Seguridad: cuida tu clave

Nunca la escribas en el código ni la subas a GitHub (usa variables de entorno).
Si trabajas en un proyecto, agrega tu archivo de claves (ej. .env) al .gitignore.
Si crees que se filtró, bórrala desde la consola y crea una nueva.
Pon un límite de gasto mensual para dormir tranquilo.

¿Listo para el siguiente paso? Aprende a crear tu primer agente de IA usando lo que acabas de conectar.

Preguntas frecuentes

¿Qué es una API de IA?

Es la puerta para que tu propio programa le hable a un modelo de IA. En vez de escribir en una web como ChatGPT o Claude, tu código manda una pregunta y recibe la respuesta, para automatizar o construir apps.

¿Necesito saber programar para conectar una API de IA?

Algo básico ayuda, pero puedes copiar el ejemplo de esta guía y cambiar solo el texto de la pregunta. Con eso ya tienes tu primera llamada funcionando.

¿Cuánto cuesta usar una API de IA?

Pagas por uso, por tokens (trozos de texto), no una mensualidad. Para pruebas es muy barato: un modelo rápido como Claude Haiku cuesta alrededor de $1 por millón de tokens de entrada. Confirma los precios actuales en la página oficial.

¿Es seguro poner mi API key en el código?

No. Guárdala como variable de entorno (Paso 4) y nunca la subas a GitHub. Si se filtra, bórrala desde la consola y crea una nueva.

¿Uso Python o Node.js?

Cualquiera de los dos sirve; esta guía muestra ambos. Si nunca has programado, Python suele ser más fácil de leer para empezar.