Claude Academy
Cargando

Realizar una solicitud

Lección 315 min

Hacer tu primera solicitud a la API de Anthropic es sencillo una vez que comprendes la configuración y estructura básicas. Esta guía recorre los pasos esenciales para lograr que Claude responda a tus prompts usando Python.

Configurar tu entorno

Antes de realizar cualquier llamada a la API, necesitas instalar los paquetes requeridos y configurar tu clave de API de forma segura.

Primero, instala las dependencias necesarias en tu notebook de Jupyter:

bash
%pip install "anthropic<1" python-dotenv

A continuación, crea un archivo .env en el mismo directorio que tu notebook para almacenar tu clave de API de forma segura:

bash
ANTHROPIC_API_KEY="your-api-key-here"

Este enfoque mantiene tu clave de API fuera de tu código y evita que la subas accidentalmente al control de versiones. Agrega siempre .env a tu archivo .gitignore.

Carga las variables de entorno y crea tu cliente de API:

python
from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-haiku-4-5"

La función Create

El núcleo para realizar solicitudes a la API es la función client.messages.create(). Esta función requiere tres parámetros clave:

La llamada client.messages.create con anotaciones que etiquetan sus tres parámetros, model, max_tokens y messages, enumerados a continuación.

  • model - El nombre del modelo de Claude que deseas usar
  • max_tokens - Un límite de seguridad sobre la longitud de la respuesta (no un objetivo)
  • messages - El historial de la conversación que estás enviando a Claude

El parámetro max_tokens actúa como un mecanismo de seguridad. Si lo configuras en 1000, Claude dejará de generar texto después de 1000 tokens incluso si tiene más que decir. Claude no intenta alcanzar este límite; simplemente escribe lo que considera apropiado y se detiene si llega al máximo.

Comprender los mensajes

Los mensajes representan la conversación entre tú y Claude, de forma similar a una aplicación de chat. Hay dos tipos de mensajes:

Ventana de chat donde el mensaje del usuario pregunta "¿Qué es la computación cuántica?" y el mensaje del asistente es la respuesta de la IA que la define.

  • Mensajes de usuario - Contenido que deseas enviar a Claude (escrito por humanos)
  • Mensajes del asistente - Respuestas que Claude ha generado

Cada mensaje es un diccionario con un role (ya sea "user" o "assistant") y content (el texto real).

Hacer tu primera solicitud

Aquí tienes un ejemplo completo de cómo hacer una solicitud a Claude:

python
message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

Cuando ejecutas este código, Claude procesará tu solicitud y devolverá un objeto de respuesta que contiene el texto generado junto con metadatos sobre la solicitud.

Extraer la respuesta

El objeto de respuesta contiene mucha información, pero normalmente solo quieres el texto generado. Accede a él usando:

python
message.content[0].text

Esto te da una salida limpia y legible como: "Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers."

Con estos conceptos básicos en su lugar, puedes comenzar a experimentar con diferentes prompts y construir interacciones más complejas con Claude.