Saltar al contenido principal

Tu primera llamada a la API

Principiante

La API permite que tu programa hable con Claude. Al final de esta lección habrás ejecutado una solicitud real y entenderás exactamente qué hace cada una de sus partes.

What you'll learn
  • Crear una clave de API y guardarla de forma segura como variable de entorno
  • Instalar el SDK oficial para Python o TypeScript (o usar cURL a secas)
  • Enviar tu primera solicitud de messages y leer la respuesta de Claude
  • Entender los cuatro campos clave: model, max_tokens, messages y system

Todo el recorrido en tres pasos​

Todo lo que viene a continuación encaja en una secuencia sencilla. Ten presente este mapa mientras avanzas.

Guided walkthrough1 of 3
  1. Crea una clave en la Anthropic Console y expórtala como variable de entorno para que nunca quede en tu código.

1. Consigue una clave de API​

Crea una en la Anthropic Console. Después, configúrala como variable de entorno para que nunca quede en tu código:

Exporta tu clave de API

export ANTHROPIC_API_KEY="sk-ant-..."
Watch out
  • Nunca subas tu clave al control de versiones. Mantén las claves en variables de entorno o en un gestor de secretos, nunca en el control de código. Consulta la página de Seguridad (/docs/security).

2. Instala el SDK​

Elige tu lenguaje. El SDK lee la clave automáticamente de la variable de entorno que acabas de configurar.

Instalación (Python)

pip install anthropic

3. Haz la llamada​

Cada solicitud es una lista de messages. El modelo responde con content. Ejecuta el fragmento para tu lenguaje y verás cómo Claude responde la pregunta.

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

Qué acaba de pasar​

Enviaste cuatro piezas de información. Esto es lo que controla cada una:

  • model — qué Claude usar. No lo codifiques a ciegas; consulta Elegir un modelo.
  • max_tokens — un tope para la longitud de la respuesta (en tokens). No define la ventana de contexto.
  • messages — la conversación hasta el momento. La API es sin estado: para continuar un chat, vuelve a enviar todo el historial cada vez.
  • system (opcional) — una instrucción de nivel superior que establece el rol de Claude para la llamada.
Los cuatro campos clave
Pulsa Intro o Espacio para girar la tarjeta. Usa las flechas izquierda y derecha para moverte entre las tarjetas.Término mostrado.
1 / 4
Pro tip
  • Como la API es sin estado, un chat de varios turnos no es más que un array de messages que crece: añade cada respuesta y reenvía la lista completa en la siguiente llamada.

Ponte a prueba

0/3
  1. ¿Qué controla max_tokens?
  2. ¿Cómo continúas una conversación de varios turnos con la API?
  3. ¿Dónde debería estar tu clave de API?
Key takeaways
  • Tres pasos: consigue una clave, instala el SDK, envía una solicitud de messages.
  • Guarda la clave en ANTHROPIC_API_KEY para que el SDK la lea automáticamente y nunca entre en tu código.
  • Una solicitud es una lista de messages; la respuesta vuelve en content.
  • La API es sin estado: reenvía todo el historial de la conversación para continuar un chat.
  • model, max_tokens, messages y system son los campos que usarás primero.

Siguiente​