Cómo conectar la API de Claude — portada

Cómo conectar la API de Claude: guía paso a paso para periodistas

por

TL;DR. Conectar la API de Claude es el paso que separa “copiar y pegar en un chat” de “automatizar tu redacción”. Lleva 15 minutos, no hace falta ser programador, y al final de esta guía vas a tener tu primer script funcionando: uno que resume gacetillas. Cuenta en la plataforma de Anthropic, API key guardada de forma segura, un request de prueba y el script en Python. Vamos paso a paso.

Antes de empezar: qué es la API y por qué te importa

La API es la puerta por la que un programa — un script tuyo, tu WordPress — le habla a Claude directamente, sin pasar por la ventana del chat. Pagás por uso (por tokens, es decir por cantidad de texto), no una suscripción: para un medio chico son centavos por nota. Si necesitás el panorama general de qué es Claude y sus modelos, está en la guía completa de Claude para periodistas; esta nota es la parte práctica.

Paso 1: crear la cuenta y cargar crédito

Entrá a platform.claude.com (la consola para desarrolladores de Anthropic — es una cuenta distinta a la de claude.ai). Registrate, y en la sección de facturación cargá un crédito inicial chico: con 5 dólares tenés para semanas de pruebas. Consejo: activá el límite de gasto mensual desde el primer día — es un tope de seguridad para que ningún script con un error te queme el presupuesto.

Paso 2: crear tu API key (y guardarla bien)

En la consola: API Keys → Create Key. Dale un nombre descriptivo (“redaccion-pruebas”) y copiá la clave en el momento: no se vuelve a mostrar. Tres reglas de seguridad no negociables:

  • La key va en un archivo .env aparte, nunca escrita dentro del código.
  • Ese .env jamás se sube a GitHub ni se comparte (agregalo al .gitignore).
  • Si sospechás que se filtró, la revocás en la consola y creás otra. Tarda 30 segundos.

Paso 3: el request de prueba

Desde una terminal (reemplazá TU_API_KEY por la tuya):

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: TU_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "Respondé solo: API conectada."}]
  }'

Si te devuelve un JSON con “API conectada”, ya está: tu redacción tiene línea directa con el modelo. Usamos claude-sonnet-5, el modelo equilibrado ideal para redacción — verificá los nombres vigentes en la documentación oficial de modelos porque se actualizan cada tanto.

Paso 4: tu primer script útil — el resumidor de gacetillas

Necesitás Python instalado y dos librerías: pip install anthropic python-dotenv. Creá un archivo .env con una línea: ANTHROPIC_API_KEY=tu-clave. Y este es el script completo:

# resumidor.py — pega una gacetilla, devuelve resumen + citas + checklist
import os
import anthropic
from dotenv import load_dotenv

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

gacetilla = open("gacetilla.txt", encoding="utf-8").read()

respuesta = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[{
        "role": "user",
        "content": "Sos editor de un medio digital. De esta gacetilla "
                   "devolveme: 1) resumen de 3 oraciones, 2) las citas "
                   "textuales entrecomilladas, 3) lista de datos a "
                   "verificar. No agregues nada que no este en el texto.\n\n"
                   + gacetilla
    }]
)

print(respuesta.content[0].text)

Guardá una gacetilla real como gacetilla.txt en la misma carpeta, corré python resumidor.py, y mirá el reloj: eso que acaba de pasar en 4 segundos era media hora de tu día. Ese es el momento en que la API deja de ser una curiosidad técnica.

¿Cuánto cuesta esto?

El script de arriba, con una gacetilla típica, consume del orden de 1.000-2.000 tokens: fracciones de centavo de dólar con Sonnet. Cien gacetillas por mes no llegan al dólar. El costo real de automatizar nunca es la API — es el tiempo de armar bien el flujo, y para eso está este sitio. Los precios por modelo están en la guía de Claude para periodistas.

Errores comunes del primer día

  • Pegar la key en el código y subirlo a GitHub. Hay bots escaneando repos las 24 horas buscando exactamente eso. La key va en el .env, siempre.
  • Usar el modelo más caro para todo. Para resúmenes y borradores, Sonnet sobra; Haiku alcanza para titulares y etiquetas. Los modelos grandes son para análisis complejos.
  • Olvidarse del límite de gasto. Un bucle mal escrito puede llamar a la API mil veces. Con el tope mensual configurado, el peor error te cuesta lo que definiste vos.

Qué sigue

Con la API conectada, el siguiente salto es unirla a tu WordPress: que el resumen no termine en la terminal sino como borrador cargado en tu sitio, con título y metadatos. Ese circuito completo — del audio o la gacetilla a la nota lista para editar — está desarrollado con código en la guía madre de automatización periodística. Y si algo de esta guía no te funcionó, escribime con el mensaje de error y lo destrabamos.

Dejá un comentario