La API de Claude para quienes construyen
- 01La petición, una única puerta de entrada6 min
Toda interacción con Claude pasa por un único punto de entrada HTTP, la petición POST /v1/messages, que recibe un array de turnos y siempre devuelve la misma estructura de respuesta.
- 02Roles que se sostienen, no un prerrellenado que rompe7 min
El prerrellenado del turno assistant, una práctica que empezaba la respuesta de Claude en lugar del modelo, ahora es rechazado con un error 400 en los modelos actuales; una instrucción system estable o una salida forzada lo sustituyen.
- 03Las herramientas, Claude propone, el código dispone7 min
Una herramienta se declara mediante un esquema llamado input_schema; Claude nunca la ejecuta él mismo, devuelve una solicitud de uso que el código ejecuta antes de devolver el resultado para que la conversación continúe.
- 04Recibir la respuesta en streaming6 min
El modo de streaming mantiene una única conexión HTTP abierta y entrega el texto por fragmentos a medida que se genera, y el recuento acumulado de tokens se lee en el último evento message_delta recibido, nunca en el evento final message_stop.
- 05Dos palancas de coste, la memoria en caché y el procesamiento por lotes8 min
Un prefijo de petición marcado como reutilizable cuesta una fracción reducida del precio normal cuando se relee desde la caché, y un conjunto de peticiones no urgentes tratado por lotes cuesta menos que un tratamiento inmediato, dos reducciones que se acumulan entre sí y con los demás modificadores de precio.
- 06Contar antes de enviar, la ventana de contexto6 min
Un punto de conteo dedicado devuelve el número de tokens de una petición antes de enviarla, y la ventana de contexto con la que comparar esa cifra ya no es un valor común a toda una gama de modelos, ahora varía fuertemente de una familia a otra.
- 07Elegir un modelo, cambiarlo, encajar un rechazo9 min
La elección de un modelo es un compromiso entre calidad, velocidad y coste que se revisa en cada nueva generación, y un rechazo devuelto por un clasificador de seguridad se trata como un caso normal del protocolo, no como una averia.