Obtener gasto en IA
Gasto en IA de un periodo, por facturador, proveedor del modelo, modelo o centro de coste.
GET/v1/workspaces/{regionId}/ai-spend
Parámetros
periodstringEl mes, YYYY-MM. Por defecto, el mes en curso.
groupBy"invoicer" | "vendor" | "model" | "costCenter"Qué es cada grupo. Por defecto invoicer, que coincide con tus facturas. vendor suma un proveedor de modelos entre facturadores (lo que gastas en Claude, lo facture quien lo facture), model un id de modelo tal como se factura, costCenter los centros de coste de las reglas de atribución.
Devuelve
200 OK con el objeto que se muestra en la respuesta.
Más detalles
Para un periodo (por defecto, el mes en curso), el gasto en IA de cada facturador conectado, agrupado según groupBy: mes en curso, previsión para todo el periodo, último mes cerrado y variación frente a él, con el consumo por medidor y, junto a cada facturador, las líneas de orden de compra abiertas emitidas a su nombre y lo que les queda. Las cifras son las líneas de IA que sincronizaron las conexiones (a diario para current_cost, como el coste del mes en curso hoy). Un facturador cuya conexión solo lee facturas muestra el mes cerrado: su mes en curso y su previsión no aparecen (una cuenta de AWS que solo lee facturas no tiene líneas de IA y figura en notReadable). La previsión es la del proveedor cuando la ofrece (AWS Cost Explorer); si no, lineal sobre los días transcurridos. Los importes están en la moneda de facturación de cada facturador, y los totales son una entrada por moneda, nunca sumados entre monedas. Agrupar por costCenter sigue las reglas de atribución (GetAiAttribution); una línea con la que no coincide ninguna regla queda sin atribuir.
Campos de la respuesta
periodstringEl mes al que corresponden las cifras, YYYY-MM.
asOfstringCuándo se sincronizó la línea más reciente, ISO 8601. El mes en curso es a esa fecha, no a ahora.
totalsArray<object>Una entrada por moneda de facturación, nunca sumadas entre monedas: monthToDate, forecast para todo el periodo, lastMonth (el último mes cerrado) y changePct, la variación de la previsión frente a lastMonth en porcentaje.
groups[].keystringSegún groupBy: el id de la conexión de nube del facturador; el proveedor del modelo (anthropic, openai, google, meta, mistral, amazon, microsoft, cohere, xai, deepseek o unknown para un tipo de uso que Pleaxy aún no ha mapeado); el id del modelo tal como se factura, p. ej. claude-sonnet-4-5 o gemini-2.5-pro; o el código del centro de coste.
groups[].labelstringQué mostrar para el grupo: la etiqueta de cuenta de la conexión, el nombre del proveedor del modelo, el nombre del modelo o el nombre del centro de coste.
groups[].invoicerstringQuién factura el gasto del grupo, una nube o un proveedor de IA, con invoicerId como su conexión: siempre con groupBy invoicer y, para un grupo por proveedor de modelo o por modelo, cuando una sola conexión lo factura todo (Claude solo a través de Bedrock, por ejemplo); ausente cuando son varias. Un grupo por centro de coste nunca lo tiene.
groups[].monthToDatenumberEn la moneda del grupo, con forecast, lastMonth y changePct como en totals. monthToDate y forecast no aparecen para un facturador cuya conexión solo lee facturas: muestra solo lastMonth.
groups[].quantitiesArray<object>El consumo por medidor. Líneas medidas en tokens: input_tokens, output_tokens, cached_input_tokens, cache_write_tokens, batch_input_tokens, batch_output_tokens, images, audio_seconds, embeddings_tokens o requests. Líneas de capacidad: gpu_hours, ptu_hours, model_units_hours o cluster_hours. other para una línea que Pleaxy aún no ha mapeado a un medidor. unit es la unidad de la cantidad: 1M_tokens, tokens, requests, images, seconds, gpu_hours, ptu_hours, model_unit_hours o units para una línea sin mapear.
groups[].purchaseOrdersArray<object>Las líneas de orden de compra abiertas emitidas al facturador del grupo, con lo que queda en cada una (remaining, en la moneda del grupo) tras las facturas ya cargadas contra ella. Solo para un grupo con facturador.
groups[].servicesArray<object>Solo con groupBy invoicer: las cifras del grupo por servicio propio del proveedor (Amazon Bedrock, con los modelos del marketplace que factura; Amazon SageMaker; Vertex AI; ...), tal como las muestra la pestaña Cloud de la página Gasto.
unattributedArray<object>Solo con groupBy costCenter: el gasto que ninguna regla de atribución ha asignado, una entrada por moneda con la forma de un grupo, visible y nunca oculto. Escribe una regla para él con SetAiAttribution.
notReadableArray<object>Las cuentas conectadas sin líneas de IA, y por qué: needs_current_cost para una cuenta de AWS cuya conexión no permite el coste actual (AWS da sus líneas de IA solo a través de Cost Explorer), not_synced_yet para una cuyas líneas de IA aún no se han leído. No aparece cuando no hay ninguna.
Errores
- 400 Bad Request - period no es un mes en formato YYYY-MM, o groupBy no es invoicer, vendor, model ni costCenter.
- 401 Unauthorized - No se presentó ninguna credencial, o el token Bearer o el valor de X-Api-Key falta, no es válido, caducó o fue revocado.
- 403 Forbidden - El token Bearer o la clave de API del llamador no da acceso a este espacio de trabajo (regionId), o no tiene el rol requerido.
GET /v1/workspaces/reg_01k5x8p9j3q7vn2mhb4tzc6rde.buyer/ai-spend?period=2026-10&groupBy=vendor{
"period": "2026-10",
"asOf": "2026-10-29T06:10:00.000Z",
"totals": [
{ "currency": "USD", "monthToDate": 57280.14, "forecast": 61400, "lastMonth": 48930.55, "changePct": 25.5 }
],
"groups": [
{
"key": "anthropic",
"label": "Anthropic",
"invoicer": "aws",
"invoicerId": "conn_01k7q2n4m8b3xd5fwj9hz6rsvt",
"currency": "USD",
"monthToDate": 44612.3,
"forecast": 47830,
"lastMonth": 38104.2,
"changePct": 25.5,
"quantities": [
{ "meter": "input_tokens", "unit": "1M_tokens", "quantity": 7120.4 },
{ "meter": "output_tokens", "unit": "1M_tokens", "quantity": 918.3 },
{ "meter": "cached_input_tokens", "unit": "1M_tokens", "quantity": 15480 },
{ "meter": "cache_write_tokens", "unit": "1M_tokens", "quantity": 1288.7 }
],
"purchaseOrders": [ { "poId": "PO-8842", "lineNo": 1, "remaining": 4200 } ]
},
{
"key": "amazon",
"label": "Amazon",
"invoicer": "aws",
"invoicerId": "conn_01k7q2n4m8b3xd5fwj9hz6rsvt",
"currency": "USD",
"monthToDate": 12667.84,
"forecast": 13570,
"lastMonth": 10826.35,
"changePct": 25.3,
"quantities": [
{ "meter": "input_tokens", "unit": "1M_tokens", "quantity": 10874.8 },
{ "meter": "output_tokens", "unit": "1M_tokens", "quantity": 1240 }
],
"purchaseOrders": [ { "poId": "PO-8842", "lineNo": 1, "remaining": 4200 } ]
}
]
}