--- title: Descripción general de la API url: https://platform.claude.com/docs/es/api/overview description: Comprende los endpoints disponibles de la API de Claude, los encabezados de autenticación, los SDK de cliente, la paginación, los límites de velocidad y las opciones de acceso a plataformas en la nube. --- 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 los Claude Managed Agents. **¿Nuevo en Claude?** Para acceso directo a los modelos, comienza con [Comenzar](https://platform.claude.com/docs/es/get-started) y [Trabajar con Mensajes](https://platform.claude.com/docs/es/build-with-claude/working-with-messages). Para infraestructura de agentes gestionados, consulta la [guía de inicio rápido de Claude Managed Agents](https://platform.claude.com/docs/es/managed-agents/quickstart). ## Requisitos previos Para usar la API de Claude, necesitarás: * Una [cuenta de Claude Console](https://platform.claude.com) * Una [clave de API](https://platform.claude.com/settings/keys) de la Console, o una regla configurada de [Workload Identity Federation](https://platform.claude.com/docs/es/manage-claude/workload-identity-federation) Para obtener instrucciones de configuración paso a paso, consulta [Comenzar](https://platform.claude.com/docs/es/get-started). ## APIs disponibles La API de Claude incluye las siguientes APIs: * **[Messages API](https://platform.claude.com/docs/es/api/messages/create)**: Envía mensajes a Claude para interacciones conversacionales (`POST /v1/messages`) * **[Message Batches API](https://platform.claude.com/docs/es/api/messages/batches/create)**: 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](https://platform.claude.com/docs/es/api/messages/count_tokens)**: Cuenta los tokens en un mensaje antes de enviarlo para gestionar costos y límites de velocidad (`POST /v1/messages/count_tokens`) * **[Models API](https://platform.claude.com/docs/es/api/models/list)**: Lista los modelos de Claude disponibles y sus detalles (`GET /v1/models`) * **[Files API](https://platform.claude.com/docs/es/api/files/upload)**: Sube y gestiona archivos para usar en múltiples llamadas a la API (`POST /v1/files`, `GET /v1/files`) * **[Skills API](https://platform.claude.com/docs/es/api/skills/create)**: Crea y gestiona habilidades de agente personalizadas (`POST /v1/skills`, `GET /v1/skills`) Las siguientes APIs están en beta: * **[Agents API](https://platform.claude.com/docs/es/managed-agents/agent-setup)**: Define configuraciones de agente reutilizables y versionadas para Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`) * **[Sessions API](https://platform.claude.com/docs/es/managed-agents/sessions)**: Ejecuta sesiones de agente con estado en sandboxes gestionados en la nube (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`) * **[Environments API](https://platform.claude.com/docs/es/managed-agents/environments)**: Configura plantillas de sandbox para sesiones de agente (`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 [Beta headers](https://platform.claude.com/docs/es/api/beta-headers). ## Autenticación Para obtener detalles sobre cada método de autenticación y cuándo usarlo, consulta [Autenticación](https://platform.claude.com/docs/es/manage-claude/authentication). Las solicitudes a la API de Claude incluyen estos encabezados: | Encabezado | Valor | Obligatorio | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Authorization` | `Bearer `, donde `` es tu clave de API o un token de acceso de corta duración obtenido de `POST /v1/oauth/token` mediante [Workload Identity Federation](https://platform.claude.com/docs/es/manage-claude/workload-identity-federation) | Sí, a menos que se establezca `x-api-key` | | `x-api-key` | Tu clave de API de la Console. Alternativa heredada a `Authorization`, todavía compatible | No | | `anthropic-workspace-id` | ID del [workspace](https://platform.claude.com/docs/es/manage-claude/workspaces) en el que se ejecuta la solicitud (por ejemplo, `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). Consulta [Seleccionar un workspace](https://platform.claude.com/docs/es/manage-claude/authentication#select-a-workspace). | Obligatorio con una clave de API de múltiples workspaces. Opcional para otras claves de API. Una clave creada para un solo workspace se ejecuta en ese workspace cuando omites el encabezado. No se usa con tokens de Workload Identity Federation, que seleccionan un workspace durante el intercambio de tokens. | | `anthropic-version` | Versión de la API (por ejemplo, `2023-06-01`) | Sí | | `content-type` | `application/json` | Sí | Si estás usando los [SDK de cliente](https://platform.claude.com/docs/es/api/overview#client-sdks), el SDK envía los encabezados de autenticación, versión y content-type automáticamente; tú pasas `anthropic-workspace-id` por tu cuenta cuando tu clave lo necesita. Para obtener detalles sobre el versionado de la API, consulta [Versiones de la API](https://platform.claude.com/docs/es/api/versioning). Al acceder a Claude a través de una [plataforma en la nube](https://platform.claude.com/docs/es/api/overview#claude-api-vs-cloud-platforms), 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 compatibles, los encabezados requeridos y las opciones de autenticación. ### Obtener claves de API La API está disponible a través de la [Console](https://platform.claude.com/) web. En la Console, puedes usar el [playground](https://platform.claude.com/playground) (`platform.claude.com/playground`) para probar la API en el navegador y luego generar claves de API en la página [Claves de API](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`). Para saber cómo hacerlo, consulta [Obtén tu clave de API de Claude](https://platform.claude.com/docs/es/get-api-key). Eliges el tipo de cada clave (consulta [Tipos de clave](https://platform.claude.com/docs/es/manage-claude/authentication#key-types)) y su [expiración](https://platform.claude.com/docs/es/manage-claude/authentication#key-expiration) al crearla. Usa [workspaces](https://platform.claude.com/settings/workspaces) en la Console para separar entornos y [controlar el gasto](https://platform.claude.com/docs/es/api/rate-limits) por caso de uso. ## SDK de cliente Anthropic proporciona SDK oficiales que simplifican la integración de 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 (autenticación, `anthropic-version`, `content-type`) * Manejo de solicitudes y respuestas con seguridad de tipos * Lógica de reintento y manejo de errores integrados * Compatibilidad con streaming * Tiempos de espera de solicitudes y gestión de conexiones Para obtener una lista de los SDK de cliente, consulta [SDK de cliente](https://platform.claude.com/docs/es/cli-sdks-libraries/overview). ## 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](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws) y [Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry); las plataformas operadas por socios incluyen Amazon Bedrock y Google Cloud. Consulta la página de cada plataforma para conocer la disponibilidad y los tiempos de las funciones. * **Ideal para:** Compromisos existentes en la nube, requisitos de cumplimiento específicos, facturación consolidada en la nube | Plataforma | Proveedor | Documentación | | ---------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | Agent Platform | Google Cloud | [Claude en Google Cloud](https://platform.claude.com/docs/es/build-with-claude/claude-on-vertex-ai) | | Amazon Bedrock | AWS | [Claude en Amazon Bedrock](https://platform.claude.com/docs/es/build-with-claude/claude-in-amazon-bedrock) | | Claude Platform on AWS | AWS (operado por Anthropic) | [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws) | | Microsoft Foundry | Microsoft Azure (operado por Anthropic) | [Claude en Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry) | Claude Managed Agents está disponible a través de la API directa de Claude y [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws). Para conocer la disponibilidad de funciones en las distintas plataformas, consulta la [Descripción general de funciones](https://platform.claude.com/docs/es/build-with-claude/overview). ## Formato de solicitud y respuesta ### Límites de tamaño de solicitud | Endpoint | Tamaño máximo de solicitud | | --------------------------------------------------------------------------------------------- | -------------------------- | | Messages, Token Counting | 32 MB | | [Message Batches API](https://platform.claude.com/docs/es/build-with-claude/batch-processing) | 256 MB | | [Files API](https://platform.claude.com/docs/es/build-with-claude/files) | 500 MB | | Sessions, Agents, Environments | 32 MB | Si excedes estos límites, recibirás un error 413 `request_too_large`. Las plataformas operadas por socios tienen sus propios límites de tamaño de solicitud: Bedrock limita las solicitudes a 20 MB, y Google Cloud limita las solicitudes a 30 MB. Claude Platform on AWS usa los mismos límites que la API directa de Claude. Consulta la documentación de tu plataforma para conocer los valores actuales. ### Encabezados de respuesta La API de Claude incluye los siguientes encabezados en sus respuestas: | Encabezado | Descripción | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `request-id` | Un identificador único global para la solicitud, como `req_018EeWyXxfu5pfWkrYcMdjWG`. Inclúyelo cuando contactes al soporte sobre una solicitud específica. Consulta [Request ID](https://platform.claude.com/docs/es/api/errors#request-id). | | `anthropic-organization-id` | El ID de la organización a la que pertenece la clave de API o el token de acceso usado en la solicitud. | | `anthropic-workspace-id` | El ID con prefijo `wrkspc_` del [workspace](https://platform.claude.com/docs/es/manage-claude/workspaces) al que se resolvió la clave de API o el token de acceso, como `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, incluso cuando ese es el Workspace predeterminado de tu organización. Ausente cuando la credencial no se resuelve a un workspace (por ejemplo, en solicitudes de la Admin API) o la solicitud falla antes de que se complete la autenticación. Consulta [Identificar el workspace detrás de una respuesta de la API](https://platform.claude.com/docs/es/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). | Para los encabezados de límite de velocidad, consulta [Encabezados de respuesta](https://platform.claude.com/docs/es/api/rate-limits#response-headers) en Límites de velocidad. Para ejemplos que leen un encabezado de respuesta por nombre con cada SDK, consulta [Identificar el workspace detrás de una respuesta de la API](https://platform.claude.com/docs/es/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). Claude Platform on AWS agrega un ID de solicitud de AWS (`x-amzn-requestid`) junto con el encabezado estándar `request-id`. Consulta [Request IDs](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws#request-ids) para conocer el patrón de manejo de doble ID. ## Paginación Los endpoints de lista devuelven resultados en páginas. La mayoría de los endpoints de lista más recientes usan el esquema de cursor `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 array `data` junto con campos de cursor para navegar entre páginas. | Nombre | Ubicación | Descripción | | ----------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `limit` | Parámetro de consulta | Número máximo de elementos a devolver por página. | | `page` | Parámetro de consulta | Cursor opaco de una respuesta anterior. Pasa un valor `next_page` o `prev_page` aquí para obtener la página adyacente. | | `order` | Parámetro de consulta | Dirección de ordenamiento para los resultados (`asc` o `desc`), en los endpoints de lista que admiten ordenamiento. Un cursor `page` solo es válido con el `order` con el que se creó. | | `next_page` | Campo de respuesta | Cursor para la página siguiente, o `null` si no hay más resultados. | | `prev_page` | Campo de respuesta | Cursor para la página anterior en los endpoints que admiten paginación hacia atrás (actualmente `GET /v1/sessions`), o `null` si estás en la primera página. Otros endpoints de lista omiten el campo. | 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 lista admiten `prev_page`. Solo `GET /v1/sessions` devuelve `prev_page`; en los endpoints de lista 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](https://platform.claude.com/docs/es/managed-agents/session-operations#listing-sessions). El SDK proporciona un iterador con paginación automática que sigue `next_page` por ti. Por ejemplo, `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) recorre todas las sesiones. La paginación automática del SDK solo avanza 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](https://platform.claude.com/docs/es/cli-sdks-libraries/overview) para obtener más detalles. Algunos endpoints de lista usan un esquema de cursor diferente. La [Message Batches API](https://platform.claude.com/docs/es/build-with-claude/batch-processing), la [Models API](https://platform.claude.com/docs/es/api/models/list) y varios endpoints de la [Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api) toman los parámetros de consulta `after_id` y `before_id` en lugar de `page`. Sus respuestas devuelven `has_more`, `first_id` y `last_id` en lugar de `next_page`. Consulta la página de referencia de cada endpoint para conocer sus campos de paginación exactos. ## 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 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 para 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 [Límites de velocidad](https://platform.claude.com/usage/limits) y tus límites de gasto en la página [Facturación](https://platform.claude.com/settings/billing) de la Console. Para obtener límites de velocidad más altos o un tope de gasto mensual más alto, usa **Request tier increase** en la página de Límites de velocidad. Para obtener información detallada sobre los límites, niveles y el algoritmo de token bucket usado para la limitación de velocidad, consulta [Límites de velocidad](https://platform.claude.com/docs/es/api/rate-limits). ### Disponibilidad La API de Claude está disponible en [muchos países y regiones](https://platform.claude.com/docs/es/api/supported-regions) de todo el mundo. Consulta la página de regiones compatibles para confirmar la disponibilidad en tu ubicación. ## Próximos pasos Especificación completa de la API para interacciones directas con modelos Endpoints de Agents, Sessions y Environments Python, TypeScript, C#, Go, Java, PHP y Ruby Niveles de uso, solicitud de límites más altos y el algoritmo de token bucket