Descripción general de la API

La API de Claude es una API RESTful en https://api.anthropic.com que proporciona acceso programático a los modelos de Claude y a Claude Managed Agents.



Requisitos previos

Para usar la API de Claude, necesitarás:

• Una cuenta de Claude Console
• Una clave de API, o una regla configurada de Workload Identity Federation

Para instrucciones de configuración paso a paso, consulta Primeros pasos.



APIs disponibles

La API de Claude incluye las siguientes APIs:

Disponibilidad general:

• Messages API: Envía mensajes a Claude para interacciones conversacionales (POST /v1/messages)
• Message Batches API: Procesa grandes volúmenes de solicitudes de Messages de forma asíncrona con una reducción de costos del 50% (POST /v1/messages/batches)
• Token Counting API: Cuenta los tokens de un mensaje antes de enviarlo para gestionar costos y límites de velocidad (POST /v1/messages/count_tokens)
• Models API: Lista los modelos de Claude disponibles y sus detalles (GET /v1/models)

Beta:

• Files API: Sube y gestiona archivos para usarlos en múltiples llamadas a la API (POST /v1/files, GET /v1/files)
• Skills API: Crea y gestiona habilidades personalizadas de agentes (POST /v1/skills, GET /v1/skills)
• Agents API: Define configuraciones de agentes reutilizables y versionadas para Claude Managed Agents (POST /v1/agents, GET /v1/agents)
• Sessions API: Ejecuta sesiones de agentes con estado en sandboxes gestionados en la nube (POST /v1/sessions, GET /v1/sessions/{id}/events/stream)
• Environments API: Configura plantillas de sandbox para sesiones de agentes (POST /v1/environments, GET /v1/environments)

Para la referencia completa de la API con todos los endpoints, parámetros y esquemas de respuesta, explora las páginas de referencia de la API listadas en la navegación. Para acceder a las funciones beta, consulta Encabezados beta.



Autenticación

Para obtener detalles sobre ambos métodos de autenticación y cuándo usar cada uno, consulta Autenticación. Todas las solicitudes a la API de Claude deben incluir estos encabezados:

Si estás usando los SDK de cliente, el SDK enviará estos encabezados automáticamente. Para detalles sobre el versionado de la API, consulta Versiones de la API.

Al acceder a Claude a través de una plataforma en la nube, la autenticación está integrada con el sistema IAM del proveedor de la nube. Consulta la documentación específica de la plataforma para conocer los tipos de credenciales admitidos, los encabezados requeridos y las opciones de autenticación.



Obtener claves de API

La API está disponible a través de la Consola web. Puedes usar el Workbench para probar la API en el navegador y luego generar claves de API en Configuración de la cuenta. Eliges la expiración de cada clave cuando la creas. Usa workspaces para segmentar tus claves de API y controlar el gasto por caso de uso.



SDK de cliente

Anthropic proporciona SDK oficiales que simplifican la integración con la API al gestionar la autenticación, el formato de las solicitudes, el manejo de errores y más.

Beneficios:

• Gestión automática de encabezados (x-api-key, anthropic-version, content-type)
• Manejo de solicitudes y respuestas con seguridad de tipos
• Lógica de reintentos y manejo de errores integrados
• Soporte para streaming
• Tiempos de espera de solicitudes y gestión de conexiones

Para una lista de SDK de cliente, consulta SDK de cliente.



API de Claude vs. plataformas en la nube

Claude está disponible a través de la API directa de Claude y a través de plataformas en la nube. Elige según tu infraestructura, disponibilidad de funciones, requisitos de cumplimiento y preferencias de precios.



API de Claude

• Acceso directo a los modelos y funciones más recientes
• Facturación y soporte de Anthropic
• Ideal para: Nuevas integraciones, acceso completo a funciones, relación directa con Anthropic



APIs de plataformas en la nube

Accede a Claude a través de AWS, Google Cloud o Microsoft Azure:

• Integrado con la facturación e IAM del proveedor de la nube
• La disponibilidad de funciones varía según la plataforma: Las plataformas operadas por Anthropic incluyen Claude Platform on AWS y Microsoft Foundry; las plataformas operadas por socios incluyen Amazon Bedrock y Google Cloud. Consulta la página de cada plataforma para conocer la disponibilidad de funciones y los plazos.
• Ideal para: Compromisos existentes con la nube, requisitos de cumplimiento específicos, facturación consolidada en la nube



Formato de solicitud y respuesta



Límites de tamaño de solicitud

Si excedes estos límites, recibirás un error 413 request_too_large.



Encabezados de respuesta

La API de Claude incluye los siguientes encabezados en cada respuesta:

• request-id: Un identificador único global para la solicitud
• anthropic-organization-id: El ID de la organización asociado con la clave de API utilizada en la solicitud



Paginación

Los endpoints de listado devuelven resultados en páginas. La mayoría de los endpoints de listado más recientes usan el esquema de cursores page y next_page descrito en esta sección. Algunos usan un esquema diferente; consulta la nota al final de esta sección. Usa el parámetro de consulta limit para controlar el tamaño de la página y el parámetro de consulta page para obtener una página adyacente. Cada respuesta incluye un arreglo data junto con campos de cursor para navegar entre páginas.

Para retroceder una página, pasa prev_page como el parámetro page. prev_page es null cuando estás en la primera página. No todos los endpoints de listado admiten prev_page. Solo GET /v1/sessions devuelve prev_page; en los endpoints de listado que no admiten paginación hacia atrás, el campo está ausente de la respuesta en lugar de ser null. Para un recorrido de solicitud, consulta Listar sesiones.

Cada SDK proporciona un iterador de paginación automática que sigue next_page por ti. En Python y TypeScript, lo obtienes iterando directamente el resultado de la lista. Los otros SDK proporcionan el iterador a través de un método separado. La paginación automática del SDK es solo hacia adelante; para retroceder una página, lee prev_page de la respuesta y pásalo tú mismo como el parámetro page. Consulta SDK de cliente para obtener detalles específicos de cada lenguaje.



Límites de velocidad y disponibilidad



Límites de velocidad

La API aplica "rate limits" (límites de velocidad) y límites de gasto para prevenir el uso indebido y gestionar la capacidad. Los límites están organizados en niveles de uso; tu organización se coloca en un nivel automáticamente y puede pasar a un nivel superior con el tiempo. Cada nivel tiene:

• Límites de gasto: Costo mensual máximo por el uso de la API
• Límites de velocidad: Número máximo de solicitudes por minuto (RPM) y tokens por minuto (TPM)

Puedes ver tus límites de velocidad en la página Rate limits y tus límites de gasto en la página Billing de la Consola. Para obtener límites de velocidad más altos o un tope de gasto mensual más alto, usa Request rate limit increase en la página Rate limits.

Para información detallada sobre límites, niveles y el algoritmo de token bucket utilizado para la limitación de velocidad, consulta Límites de velocidad.



Disponibilidad

La API de Claude está disponible en muchos países y regiones de todo el mundo. Consulta la página de regiones admitidas para confirmar la disponibilidad en tu ubicación.



Próximos pasos