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

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

1. Entra a https://console.anthropic.com y crea tu cuenta.
2. En el menú de la izquierda abre API Keys.
3. 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.

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

1. En la consola abre Settings → Billing.
2. 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.

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.

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.

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

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

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

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.

• 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.