--- title: API de uso y costos url: https://platform.claude.com/docs/es/manage-claude/usage-cost-api description: Accede de forma programática a los datos de uso y costos de la API de tu organización con la Admin API de uso y costos. --- **La Admin API no está disponible para cuentas individuales.** Para colaborar con compañeros de equipo y agregar miembros, configura tu organización en la página [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) en la Claude Console. La Admin API de uso y costos proporciona acceso programático y detallado a los datos históricos de uso y costos de la API de tu organización. Estos datos son similares a la información disponible en la página [Uso](https://platform.claude.com/usage) (`platform.claude.com/usage`) y en la página [Costo](https://platform.claude.com/cost) (`platform.claude.com/cost`) de la Claude Console. Esta API te permite monitorear, analizar y optimizar mejor tus implementaciones de Claude: * **Seguimiento preciso del uso:** Obtén conteos de tokens y patrones de uso precisos en lugar de depender únicamente del conteo de tokens de las respuestas * **Conciliación de costos:** Haz coincidir los registros internos con la facturación de Anthropic para los equipos de finanzas y contabilidad * **Rendimiento y mejora del producto:** Monitorea el rendimiento del producto mientras mides si los cambios en el sistema lo han mejorado, o configura alertas * **Optimización del [límite de velocidad](https://platform.claude.com/docs/es/api/rate-limits):** Optimiza funciones como el [almacenamiento en caché de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) o prompts específicos para aprovechar al máximo tu capacidad asignada. * **Análisis avanzado:** Realiza análisis de datos más profundos que los disponibles en la Console **Se requieren credenciales de la Admin API.** Estos endpoints forman parte de la Admin API. Puedes acceder a ellos usando una [clave de Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api-keys), un token de OAuth con el alcance `org:admin`, o una clave personal o de cuenta de servicio que no esté limitada a un espacio de trabajo; las claves de API de espacio de trabajo no funcionan. Consulta [Autenticación](https://platform.claude.com/docs/es/manage-claude/admin-api#authentication) para obtener más detalles. Las organizaciones de Claude Enterprise usan en su lugar una clave de API de Analytics con una API diferente; consulta [¿Qué API necesitas?](https://platform.claude.com/docs/es/manage-claude/usage-cost-api#which-api-do-you-need). **Claude Platform en AWS:** Los endpoints programáticos de la API de uso y costos no están disponibles actualmente. En su lugar, consulta los datos de uso y costos en las páginas **Usage** y **Cost** de la Claude Console. ## ¿Qué API necesitas? Anthropic proporciona informes de costos y uso a través de dos APIs, según el producto de Claude que administre tu organización: | Tu organización | API | Tipo de clave | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude Console (Claude Platform) | La API de administración de uso y costos descrita en esta página | Clave de API de administración (`sk-ant-admin01-...`) u otra [credencial de la API de administración](https://platform.claude.com/docs/es/manage-claude/admin-api#authentication) | | Claude Enterprise (claude.ai) | Los endpoints de costos y uso de la [Claude Enterprise Analytics API](https://platform.claude.com/docs/es/api/beta/organization/analytics) | Clave de API de Analytics | Las organizaciones principales de Claude Enterprise no aparecen en la Claude Console y no tienen claves de API de administración, por lo que para ellas la clave de API de Analytics es la única vía para acceder a estos datos. Consulta [APIs de Analytics](https://platform.claude.com/docs/es/manage-claude/analytics-api) para saber cómo crear cada tipo de clave y a qué planes se aplican los datos de costos de Claude Enterprise. ## Soluciones de socios Las principales plataformas de observabilidad ofrecen integraciones listas para usar para monitorear el uso y los costos de tu API de Claude, sin escribir código personalizado. Estas integraciones proporcionan paneles, alertas y análisis para ayudarte a administrar el uso de tu API de manera efectiva. Plataforma de inteligencia en la nube para el seguimiento y la previsión de costos Observabilidad de LLM con rastreo y supervisión automáticos Integración sin agentes para una observabilidad de LLM sencilla con paneles y alertas listos para usar Plataforma de FinOps para la gestión de costos de nube e IA Consultas y visualización avanzadas mediante OpenTelemetry Atribución de uso y costos a elementos de trabajo de Jira Plataforma de FinOps para la observabilidad de costos y uso de LLM ## Inicio rápido Obtén el uso diario de tu organización durante los últimos 7 días: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-08T00:00:00Z&\ ending_at=2025-01-15T00:00:00Z&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` **Configura un encabezado User-Agent para las integraciones** Si estás creando una integración, configura tu encabezado User-Agent para ayudar a Anthropic a comprender los patrones de uso: ```text wrap User-Agent: YourApp/1.0.0 (https://yourapp.com) ``` ## API de uso Realiza un seguimiento del consumo de tokens en toda tu organización con desgloses detallados por modelo, espacio de trabajo y nivel de servicio con el endpoint `/v1/organizations/usage_report/messages`. ### Conceptos clave * **Intervalos de tiempo (time buckets):** Agrega los datos de uso en intervalos fijos (`1m`, `1h` o `1d`) * **Seguimiento de tokens:** Mide los tokens de entrada sin caché, de entrada en caché, de creación de caché y de salida * **Filtrado y agrupación:** Filtra por clave de API, espacio de trabajo, modelo, nivel de servicio, ventana de contexto, [residencia de datos](https://platform.claude.com/docs/es/manage-claude/data-residency) o velocidad, y agrupa los resultados por estas dimensiones * **Uso de herramientas de servidor:** Realiza un seguimiento del uso de herramientas del lado del servidor, como la búsqueda web Para obtener los detalles completos de los parámetros y los esquemas de respuesta, consulta la [referencia de la API de uso](https://platform.claude.com/docs/es/api/beta/organization/usage_report/retrieve_messages). ### Ejemplos básicos #### Uso diario por modelo ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Uso por hora con filtrado ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-15T00:00:00Z&\ ending_at=2025-01-15T23:59:59Z&\ models[]=claude-opus-5-5&\ service_tiers[]=batch&\ context_window[]=0-200k&\ bucket_width=1h" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Filtrar el uso por claves de API y espacios de trabajo ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\ api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\ workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\ workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Para obtener los ID de las claves de API de tu organización, usa el endpoint [Listar claves de API](https://platform.claude.com/docs/es/api/organization/api_keys/list). Para obtener los ID de los espacios de trabajo de tu organización, usa el endpoint [Listar espacios de trabajo](https://platform.claude.com/docs/es/api/organization/workspaces/list), o encuentra los ID de los espacios de trabajo de tu organización en la Claude Console. #### Residencia de datos Realiza un seguimiento de tus [controles de residencia de datos](https://platform.claude.com/docs/es/manage-claude/data-residency) agrupando y filtrando el uso con la dimensión `inference_geo`. Esto es útil para verificar el enrutamiento geográfico en toda tu organización. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=inference_geo&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` También puedes filtrar por una geografía específica. Los valores válidos son `global`, `us` y `not_available`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ inference_geos[]=us&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Los modelos lanzados antes de febrero de 2026 (anteriores a Claude Opus 4.6 y Claude Sonnet 4.6) no admiten el parámetro de solicitud `inference_geo`, por lo que sus informes de uso devuelven `"not_available"` para esta dimensión. Puedes usar `not_available` como valor de filtro en `inference_geos[]` para dirigirte a esos modelos. #### Modo rápido Realiza un seguimiento del uso del [modo rápido](https://platform.claude.com/docs/es/build-with-claude/fast-mode) agrupando y filtrando con la dimensión `speed`. Esto es útil para monitorear el uso del modo estándar frente al modo rápido. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=speed&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` También puedes filtrar por una velocidad específica. Los valores válidos son `standard` y `fast`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ speeds[]=fast&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ### Límites de granularidad temporal | Granularidad | Límite predeterminado | Límite máximo | Caso de uso | | ------------ | --------------------- | ---------------- | ---------------------------- | | `1m` | 60 intervalos | 1,440 intervalos | Monitoreo en tiempo real | | `1h` | 24 intervalos | 168 intervalos | Patrones diarios | | `1d` | 7 intervalos | 31 intervalos | Informes semanales/mensuales | ## API de costos Obtén desgloses de costos a nivel de servicio en USD con el endpoint `/v1/organizations/cost_report`. ### Conceptos clave * **Moneda:** Todos los costos en USD, reportados como cadenas decimales en las unidades más bajas (centavos) * **Tipos de costos:** Realiza un seguimiento de los costos de uso de tokens, búsqueda web y ejecución de código * **Agrupación:** Agrupa los costos por espacio de trabajo o descripción para obtener desgloses detallados. Al agrupar por `description`, las respuestas incluyen campos analizados como `model` e `inference_geo` * **Intervalos de tiempo:** Solo granularidad diaria (`1d`) Para obtener los detalles completos de los parámetros y los esquemas de respuesta, consulta la [referencia de la API de costos](https://platform.claude.com/docs/es/api/beta/organization/cost_report/retrieve). Los costos de Priority Tier usan un modelo de facturación diferente y no se incluyen en el endpoint de costos. En su lugar, realiza un seguimiento del uso de Priority Tier a través del endpoint de uso. ### Ejemplo básico ```bash cURL curl "https://api.anthropic.com/v1/organizations/cost_report?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ group_by[]=workspace_id&\ group_by[]=description" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Paginación Ambos endpoints admiten paginación para conjuntos de datos grandes: 1. Realiza tu solicitud inicial. 2. Si `has_more` es `true`, usa el valor `next_page` en tu siguiente solicitud. 3. Continúa hasta que `has_more` sea `false`. ```bash cURL # Primera solicitud curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" # La respuesta incluye: "has_more": true, "next_page": "page_xyz..." # Siguiente solicitud con paginación curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7&\ page=page_xyz..." \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Casos de uso comunes Explora implementaciones detalladas en el [Claude Cookbook](https://platform.claude.com/cookbook): * **Informes de uso diario:** Realiza un seguimiento de las tendencias de consumo de tokens * **Atribución de costos:** Asigna gastos por espacio de trabajo para la refacturación interna * **Eficiencia de la caché:** Mide y optimiza el almacenamiento en caché de prompts * **Monitoreo de presupuesto:** Configura alertas para umbrales de gasto * **Exportación a CSV:** Genera informes para los equipos de finanzas ## Preguntas frecuentes ### ¿Qué tan actualizados están los datos? Los datos de uso y costos suelen aparecer dentro de los 5 minutos posteriores a la finalización de la solicitud a la API, aunque ocasionalmente los retrasos pueden ser mayores. ### ¿Cuál es la frecuencia de sondeo recomendada? La API admite un sondeo de una vez por minuto para un uso sostenido. Para ráfagas cortas (por ejemplo, al descargar datos paginados), es aceptable un sondeo más frecuente. Almacena en caché los resultados para los paneles que necesiten actualizaciones frecuentes. ### ¿Cómo realizo un seguimiento del uso de la ejecución de código? Los costos de ejecución de código aparecen en el endpoint de costos agrupados bajo `Code Execution Usage` en el campo de descripción. La ejecución de código no se incluye en el endpoint de uso. ### ¿Cómo realizo un seguimiento del uso de Priority Tier? Filtra o agrupa por `service_tier` en el endpoint de uso y busca el valor `priority`. Los costos de Priority Tier no están disponibles en el endpoint de costos. ### ¿Qué sucede con el uso del playground? El uso de la API desde el playground en la Claude Console (y desde el Workbench heredado antes de él) no está asociado a una clave de API, por lo que `api_key_id` será `null` incluso al agrupar por esa dimensión. ### ¿Cómo se representa el espacio de trabajo predeterminado? El uso y los costos atribuidos al espacio de trabajo predeterminado tienen un valor `null` para `workspace_id`. ### ¿Cómo obtengo desgloses de costos por usuario para Claude Code? Usa la [API de Analytics de Claude Code](https://platform.claude.com/docs/es/manage-claude/claude-code-analytics-api), que proporciona costos estimados por usuario y métricas de productividad sin las limitaciones de rendimiento de desglosar los costos por muchas claves de API. Para el uso general de la API con muchas claves, usa la [API de uso](https://platform.claude.com/docs/es/manage-claude/usage-cost-api#usage-api) para realizar un seguimiento del consumo de tokens como indicador aproximado del costo. ## Ver también Usa las APIs de uso y costos para ofrecer una mejor experiencia a tus usuarios, administrar los costos y preservar tu límite de velocidad. Obtén más información sobre algunas de estas otras funciones: * [API de administración](https://platform.claude.com/docs/es/manage-claude/admin-api) * [Referencia de la API de administración](https://platform.claude.com/docs/es/api/beta/organization) * [APIs de Analytics](https://platform.claude.com/docs/es/manage-claude/analytics-api) - Qué API de analytics y tipo de clave necesita tu organización * [Precios](https://platform.claude.com/docs/es/about-claude/pricing) * [Almacenamiento en caché de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) - Optimiza los costos con el almacenamiento en caché * [Procesamiento por lotes](https://platform.claude.com/docs/es/build-with-claude/batch-processing) - 50% de descuento en solicitudes por lotes * [Límites de velocidad](https://platform.claude.com/docs/es/api/rate-limits) - Comprende los niveles de uso * [API de límites de velocidad](https://platform.claude.com/docs/es/manage-claude/rate-limits-api) - Consulta tus límites de velocidad configurados * [Residencia de datos](https://platform.claude.com/docs/es/manage-claude/data-residency) - Controla la geografía de la inferencia