Obter gastos com IA
Gastos com IA de um período, por faturador, fornecedor do modelo, modelo ou centro de custo.
GET/v1/workspaces/{regionId}/ai-spend
Parâmetros
periodstringO mês, YYYY-MM. Por padrão, o mês atual.
groupBy"invoicer" | "vendor" | "model" | "costCenter"O que é cada grupo. Por padrão invoicer, que corresponde às suas faturas. vendor soma um fornecedor de modelo entre faturadores (o que você gasta com Claude, seja quem for que fature), model um id de modelo como faturado, costCenter os centros de custo das regras de atribuição.
Retorna
200 OK com o objeto mostrado na resposta.
Mais detalhes
Para um período (por padrão, o mês atual), os gastos com IA de cada faturador conectado, agrupados conforme groupBy: mês até a data, previsão para o período inteiro, último mês fechado e variação em relação a ele, com o uso por medidor e, ao lado de cada faturador, as linhas de pedido de compra abertas emitidas para ele e o que resta nelas. Os números são as linhas de IA que as conexões sincronizaram (diariamente para current_cost, como o custo do mês até a data hoje). Um faturador cuja conexão só lê faturas mostra o mês fechado: seu mês até a data e sua previsão ficam ausentes (uma conta da AWS que só lê faturas não tem linhas de IA e aparece em notReadable). A previsão é a do provedor quando ele a oferece (AWS Cost Explorer); caso contrário, linear sobre os dias decorridos. Os valores estão na moeda de faturamento de cada faturador, e os totais são uma entrada por moeda, nunca somados entre moedas. Agrupar por costCenter segue as regras de atribuição (GetAiAttribution); uma linha que nenhuma regra alcança fica sem atribuição.
Campos da resposta
periodstringO mês a que os números se referem, YYYY-MM.
asOfstringQuando a linha mais recente foi sincronizada, ISO 8601. O mês até a data é até esse momento, não até agora.
totalsArray<object>Uma entrada por moeda de faturamento, nunca somadas entre moedas: monthToDate, forecast para o período inteiro, lastMonth (o último mês fechado) e changePct, a variação da previsão em relação a lastMonth, em porcentagem.
groups[].keystringConforme groupBy: o id da conexão de nuvem do faturador; o fornecedor do modelo (anthropic, openai, google, meta, mistral, amazon, microsoft, cohere, xai, deepseek ou unknown para um tipo de uso que a Pleaxy ainda não mapeou); o id do modelo como faturado, por exemplo claude-sonnet-4-5 ou gemini-2.5-pro; ou o código do centro de custo.
groups[].labelstringO que exibir para o grupo: o rótulo da conta da conexão, o nome do fornecedor do modelo, o nome do modelo ou o nome do centro de custo.
groups[].invoicerstringQuem fatura os gastos do grupo, uma nuvem ou um provedor de IA, com invoicerId como sua conexão: sempre com groupBy invoicer e, para um grupo por fornecedor de modelo ou por modelo, quando uma única conexão fatura tudo (Claude só pelo Bedrock, digamos); ausente quando são várias. Um grupo por centro de custo nunca tem uma.
groups[].monthToDatenumberNa moeda do grupo, com forecast, lastMonth e changePct como em totals. monthToDate e forecast ficam ausentes para um faturador cuja conexão só lê faturas: ele mostra apenas lastMonth.
groups[].quantitiesArray<object>O uso por medidor. Linhas medidas em tokens: input_tokens, output_tokens, cached_input_tokens, cache_write_tokens, batch_input_tokens, batch_output_tokens, images, audio_seconds, embeddings_tokens ou requests. Linhas de capacidade: gpu_hours, ptu_hours, model_units_hours ou cluster_hours. other para uma linha que a Pleaxy ainda não mapeou para um medidor. unit é a unidade da quantidade: 1M_tokens, tokens, requests, images, seconds, gpu_hours, ptu_hours, model_unit_hours ou units para uma linha não mapeada.
groups[].purchaseOrdersArray<object>As linhas de pedido de compra abertas emitidas para o faturador do grupo, com o que resta em cada uma (remaining, na moeda do grupo) após as faturas já lançadas contra ela. Só para um grupo com faturador.
groups[].servicesArray<object>Só com groupBy invoicer: os números do grupo por serviço do próprio provedor (Amazon Bedrock, com os modelos do marketplace que ele fatura; Amazon SageMaker; Vertex AI; ...), como a aba Cloud da página Gastos os mostra.
unattributedArray<object>Só com groupBy costCenter: os gastos que nenhuma regra de atribuição alcançou, uma entrada por moeda no formato de um grupo, exibidos e nunca ocultos. Escreva uma regra para eles com SetAiAttribution.
notReadableArray<object>As contas conectadas sem linhas de IA, e o motivo: needs_current_cost para uma conta da AWS cuja conexão não permite o custo atual (a AWS fornece suas linhas de IA só pelo Cost Explorer), not_synced_yet para uma cujas linhas de IA ainda não foram lidas. Ausente quando não há nenhuma.
Erros
- 400 Bad Request - period não é um mês no formato YYYY-MM, ou groupBy não é invoicer, vendor, model nem costCenter.
- 401 Unauthorized - Nenhuma credencial foi apresentada, ou o token Bearer / valor de X-Api-Key está ausente, é inválido, expirou ou foi revogado.
- 403 Forbidden - O token Bearer ou a chave de API de quem chama não dá acesso a este espaço de trabalho (regionId), ou não tem a função exigida.
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 } ]
}
]
}