Fundamentos

Referencia básica de la API de mensajes, desde la primera llamada hasta los roles, los bloques de contenido y el streaming.

Este grupo reúne la referencia de lo que usas en cualquier aplicación con un LLM: cómo se hace una petición, qué forma tienen los mensajes, qué devuelve el modelo y cómo recibir la respuesta mientras se genera. Todo lo que viene después en la documentación (herramientas, contexto, agentes) se apoya en estas piezas.

Los ejemplos usan la API de Mensajes de Anthropic como implementación de referencia. Los conceptos (roles, bloques, motivo de parada, tokens) existen con otros nombres en otros proveedores.

Artículos

Artículo	Para qué lo consultas
Introducción a la documentación	Convenciones de la documentación, instalación del SDK, clave de API y cómo se relaciona con el roadmap.
Tu primera llamada	Parámetros obligatorios de una petición, forma de la respuesta, `stop_reason`, `usage` y errores HTTP.
La API de mensajes: roles y bloques	Roles `user` y `assistant`, alternancia, tipos de bloque y cómo mantener una conversación.
Streaming	Recibir la respuesta por fragmentos, eventos del flujo y cuándo compensa.

Por dónde empezar

Si nunca has llamado a una API de modelos, haz antes el nivel Nivel 00 · Fundamentos: enseña lo mismo paso a paso, con ejercicios. Vuelve aquí cuando necesites comprobar un parámetro, un campo de la respuesta o un caso límite.

Si ya tienes una llamada funcionando, salta a La API de mensajes: roles y bloques: casi todos los errores de principiante con agentes salen de no entender bien la estructura de bloques.