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}/stream)
• Environments API: Configura plantillas de sandbox para sesiones de agentes (, )

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 que aparecen 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 SDKs de cliente, el SDK enviará estos encabezados automáticamente. Para detalles sobre el versionado de la API, consulta Versiones de la API.

Cuando accedes a Claude a través de una plataforma en la nube, la autenticación está integrada con el sistema IAM del proveedor de 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. Usa workspaces para segmentar tus claves de API y controlar el gasto por caso de uso.



SDKs de cliente

Anthropic proporciona SDKs 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 ver una lista de SDKs de cliente, consulta SDKs 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 nube
• La disponibilidad de funciones varía según la plataforma: Las plataformas operadas por Anthropic incluyen Claude Platform en AWS y Microsoft Foundry; las plataformas operadas por socios incluyen Amazon Bedrock y Vertex AI. Consulta la página de cada plataforma para conocer la disponibilidad de funciones y los plazos.
• Ideal para: Compromisos existentes con la nube, requisitos específicos de cumplimiento, 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 globalmente único para la solicitud
• anthropic-organization-id: El ID de organización asociado con la clave de API utilizada en la solicitud



Límites de velocidad y disponibilidad



Límites de velocidad

La API aplica límites de velocidad y límites de gasto para prevenir el uso indebido y gestionar la capacidad. Los límites se organizan en niveles de uso que aumentan automáticamente a medida que usas la API. Cada nivel tiene:

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

Puedes ver los límites actuales de tu organización en la Consola. Para límites más altos o Priority Tier (niveles de servicio mejorados con gasto comprometido), contacta a ventas a través de la Consola.

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