Anthropic anunció el 29 de octubre de 2026 la Usage and Cost Analytics API, en beta, para consultar consumo y costes de organizaciones de Claude Console y Enterprise. La novedad permite atribuir gasto por modelo, espacio de trabajo, clave o identidad. Para quien mantiene un panel, la decisión práctica es cómo adaptar la integración sin interpretar mal sus datos.
Las notas oficiales del lanzamiento aclaran que la API anterior de uso y costes y los informes correspondientes de Enterprise pasan a considerarse heredados, pero siguen soportados. No se anuncia su retirada.
Dos consultas y acceso de organización
La documentación de Analytics separa GET /v1/organizations/analytics/usage, para tokens y solicitudes, de GET /v1/organizations/analytics/cost, para costes en dólares estadounidenses.
Console requiere una credencial de administración; Enterprise, una clave con permiso read:analytics, creada por el propietario principal tras habilitar el acceso. El servicio no está disponible para cuentas individuales. Las peticiones necesitan anthropic-version y la cabecera beta anthropic-beta: analytics-usage-cost-2026-08-24: esa última fecha identifica la beta, no el día de este anuncio.
Cambiar la URL no basta
Estos son los cambios que comprobaríamos antes de sustituir un informe de Console:
bucket_widthpasa atime_bucket_width, sin valor predeterminado. Para conservar series diarias hay que pedir1d.limitcuenta filas por página; ya no cuenta intervalos temporales. Hay que recorrer la paginación.- La respuesta usa filas con dimensiones en
groupy métricas enusageocost. Las combinaciones sin actividad no generan fila.
Por eso, un gráfico que espera un registro por día puede necesitar completar fechas sin consumo. Esa transformación debe distinguir un día vacío de datos todavía incompletos.
Los datos recientes pueden cambiar
El campo data_refreshed_at marca hasta dónde llega la actualización. La documentación indica una demora típica de cuatro horas, que puede alcanzar 24; los valores pueden revisarse hasta unos siete días después de terminar el mes. Nuestro criterio es usar esta fuente para análisis histórico y conciliación, conservando telemetría adecuada para decisiones inmediatas.
Otro detalle decisivo: los importes son cadenas decimales en centavos de dólar. El ejemplo oficial 41280.000000 representa 412,80 USD. amount recoge el coste tras descuentos y antes de créditos; no debe tratarse directamente como importe final de una factura.
Una transición comprobable
Ejemplo hipotético, no ejecutado por Puntoes: un equipo quiere repartir el gasto de un asistente documental entre tres espacios de trabajo. Propondríamos comparar ambos informes sobre un periodo cerrado, revisar la paginación y comprobar manualmente una muestra antes de cambiar el panel.
Si hoy aparecen menos tokens, aún habría que descartar un retraso de actualización. Incluso con datos completos, menor gasto no demuestra mejores respuestas: esa pregunta necesita su propia evaluación.
La API heredada de Console recomienda Analytics para integraciones nuevas. Para diagnosticar ejecuciones concretas, el antecedente sobre trazas de Claude y MLflow aborda otra capa de observación. Puntoes no ha realizado llamadas a esta beta ni validado una migración real.