Ottenere la spesa in IA
Spesa in IA di un periodo, per emittente, produttore del modello, modello o centro di costo.
GET/v1/workspaces/{regionId}/ai-spend
Parametri
periodstringIl mese, YYYY-MM. Per impostazione predefinita, il mese in corso.
groupBy"invoicer" | "vendor" | "model" | "costCenter"Che cos’è ogni gruppo. Per impostazione predefinita invoicer, che corrisponde alle tue fatture. vendor somma un produttore di modelli tra gli emittenti (quanto spendi per Claude, chiunque lo fatturi), model un id di modello come fatturato, costCenter i centri di costo delle regole di attribuzione.
Restituisce
200 OK con l’oggetto mostrato nella risposta.
Più dettagli
Per un periodo (per impostazione predefinita il mese in corso), la spesa in IA di ogni emittente collegato, raggruppata secondo groupBy: mese in corso, previsione per l’intero periodo, ultimo mese chiuso e variazione rispetto a esso, con il consumo per contatore e, accanto a ogni emittente, le righe di ordine d’acquisto aperte emesse a suo nome e quanto vi resta. Le cifre sono le voci di IA sincronizzate dalle connessioni (ogni giorno per current_cost, come oggi il costo del mese in corso). Un emittente la cui connessione legge solo le fatture mostra il mese chiuso: il suo mese in corso e la sua previsione sono assenti (un account AWS che legge solo le fatture non ha voci di IA ed è elencato in notReadable). La previsione è quella del provider quando la fornisce (AWS Cost Explorer), altrimenti lineare sui giorni trascorsi. Gli importi sono nella valuta di fatturazione di ciascun emittente, e i totali sono una voce per valuta, mai sommati tra valute. Raggruppare per costCenter segue le regole di attribuzione (GetAiAttribution); una voce che nessuna regola intercetta è non attribuita.
Campi della risposta
periodstringIl mese a cui si riferiscono le cifre, YYYY-MM.
asOfstringQuando è stata sincronizzata la voce più recente, ISO 8601. Il mese in corso è aggiornato a quel momento, non a ora.
totalsArray<object>Una voce per valuta di fatturazione, mai sommate tra valute: monthToDate, forecast per l’intero periodo, lastMonth (l’ultimo mese chiuso) e changePct, la variazione della previsione rispetto a lastMonth in percentuale.
groups[].keystringSecondo groupBy: l’id della connessione cloud dell’emittente; il produttore del modello (anthropic, openai, google, meta, mistral, amazon, microsoft, cohere, xai, deepseek o unknown per un tipo di utilizzo che Pleaxy non ha ancora mappato); l’id del modello come fatturato, ad es. claude-sonnet-4-5 o gemini-2.5-pro; oppure il codice del centro di costo.
groups[].labelstringCosa mostrare per il gruppo: l’etichetta dell’account della connessione, il nome del produttore del modello, il nome del modello o il nome del centro di costo.
groups[].invoicerstringChi fattura la spesa del gruppo, un cloud o un provider IA, con invoicerId come sua connessione: sempre con groupBy invoicer e, per un gruppo per produttore o per modello, quando una sola connessione fattura tutto (Claude solo tramite Bedrock, ad esempio); assente quando sono più di una. Un gruppo per centro di costo non ne ha mai uno.
groups[].monthToDatenumberNella valuta del gruppo, con forecast, lastMonth e changePct come in totals. monthToDate e forecast sono assenti per un emittente la cui connessione legge solo le fatture: mostra solo lastMonth.
groups[].quantitiesArray<object>Il consumo per contatore. Voci misurate in token: input_tokens, output_tokens, cached_input_tokens, cache_write_tokens, batch_input_tokens, batch_output_tokens, images, audio_seconds, embeddings_tokens o requests. Voci di capacità: gpu_hours, ptu_hours, model_units_hours o cluster_hours. other per una voce che Pleaxy non ha ancora mappato su un contatore. unit è l’unità della quantità: 1M_tokens, tokens, requests, images, seconds, gpu_hours, ptu_hours, model_unit_hours o units per una voce non mappata.
groups[].purchaseOrdersArray<object>Le righe di ordine d’acquisto aperte emesse all’emittente del gruppo, con quanto resta su ciascuna (remaining, nella valuta del gruppo) dopo le fatture già imputate. Solo per un gruppo con emittente.
groups[].servicesArray<object>Solo con groupBy invoicer: le cifre del gruppo per servizio del provider (Amazon Bedrock, con i modelli del marketplace che fattura; Amazon SageMaker; Vertex AI; ...), come le mostra la scheda Cloud della pagina Spesa.
unattributedArray<object>Solo con groupBy costCenter: la spesa che nessuna regola di attribuzione ha intercettato, una voce per valuta nella forma di un gruppo, mostrata e mai nascosta. Scrivi una regola per essa con SetAiAttribution.
notReadableArray<object>Gli account collegati senza voci di IA, e il motivo: needs_current_cost per un account AWS la cui connessione non consente il costo corrente (AWS fornisce le sue voci di IA solo tramite Cost Explorer), not_synced_yet per uno le cui voci di IA non sono ancora state lette. Assente quando non ce ne sono.
Errori
- 400 Bad Request - period non è un mese nel formato YYYY-MM, oppure groupBy non è invoicer, vendor, model o costCenter.
- 401 Unauthorized - Non è stata presentata alcuna credenziale, oppure il token Bearer o il valore di X-Api-Key è mancante, non valido, scaduto o revocato.
- 403 Forbidden - Il token Bearer o la chiave API del chiamante non dà accesso a questo workspace (regionId), oppure non ha il ruolo richiesto.
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 } ]
}
]
}