KI-Ausgaben abrufen
KI-Ausgaben eines Zeitraums nach Rechnungssteller, Modellanbieter, Modell oder Kostenstelle.
GET/v1/workspaces/{regionId}/ai-spend
Parameter
periodstringDer Monat, YYYY-MM. Standardmäßig der laufende Monat.
groupBy"invoicer" | "vendor" | "model" | "costCenter"Was jede Gruppe ist. Standardmäßig invoicer, was Ihren Rechnungen entspricht. vendor summiert einen Modellanbieter über Rechnungssteller hinweg (was Sie für Claude ausgeben, egal wer es abrechnet), model eine Modell-ID wie abgerechnet, costCenter die Kostenstellen der Zuordnungsregeln.
Rückgabe
200 OK mit dem in der Antwort gezeigten Objekt.
Weitere Details
Für einen Zeitraum (standardmäßig den laufenden Monat) die KI-Ausgaben jedes verbundenen Rechnungsstellers, gruppiert wie groupBy angibt: seit Monatsbeginn, die Prognose für den ganzen Zeitraum, der letzte abgeschlossene Monat und die Veränderung dazu, mit der Nutzung je Zähler und neben jedem Rechnungssteller die offenen Bestellpositionen an ihn und was darauf noch übrig ist. Die Zahlen sind die KI-Positionen, die die Verbindungen synchronisiert haben (täglich für current_cost, wie heute die Kosten seit Monatsbeginn). Ein Rechnungssteller, dessen Verbindung nur Rechnungen liest, zeigt den abgeschlossenen Monat: Seine Werte seit Monatsbeginn und seine Prognose fehlen (ein AWS-Konto, das nur Rechnungen liest, hat keine KI-Positionen und steht in notReadable). Die Prognose ist die des Anbieters, wo er eine liefert (AWS Cost Explorer), sonst linear über die vergangenen Tage. Beträge stehen in der Abrechnungswährung des jeweiligen Rechnungsstellers, und die Summen sind ein Eintrag je Währung, nie über Währungen hinweg addiert. Die Gruppierung nach costCenter folgt den Zuordnungsregeln (GetAiAttribution); eine Position, auf die keine Regel passt, ist nicht zugeordnet.
Antwortfelder
periodstringDer Monat, für den die Zahlen gelten, YYYY-MM.
asOfstringWann die neueste Position synchronisiert wurde, ISO 8601. Die Werte seit Monatsbeginn gelten zu diesem Zeitpunkt, nicht zu jetzt.
totalsArray<object>Ein Eintrag je Abrechnungswährung, nie über Währungen hinweg summiert: monthToDate, forecast für den ganzen Zeitraum, lastMonth (der letzte abgeschlossene Monat) und changePct, die Veränderung der Prognose gegenüber lastMonth in Prozent.
groups[].keystringWie groupBy angibt: die Cloud-Verbindungs-ID des Rechnungsstellers; der Modellanbieter (anthropic, openai, google, meta, mistral, amazon, microsoft, cohere, xai, deepseek oder unknown für einen Nutzungstyp, den Pleaxy noch nicht zugeordnet hat); die Modell-ID wie abgerechnet, z. B. claude-sonnet-4-5 oder gemini-2.5-pro; oder der Code der Kostenstelle.
groups[].labelstringWas für die Gruppe angezeigt wird: die Kontobezeichnung der Verbindung, der Name des Modellanbieters, der Name des Modells oder der Name der Kostenstelle.
groups[].invoicerstringWer die Ausgaben der Gruppe abrechnet, eine Cloud oder ein KI-Anbieter, mit invoicerId als dessen Verbindung: immer bei groupBy invoicer und bei einer Gruppe nach Modellanbieter oder Modell, wenn eine einzige Verbindung alles abrechnet (etwa Claude nur über Bedrock); fehlt, wenn es mehrere sind. Eine Kostenstellengruppe hat nie eine.
groups[].monthToDatenumberIn der Währung der Gruppe, mit forecast, lastMonth und changePct wie in totals. monthToDate und forecast fehlen bei einem Rechnungssteller, dessen Verbindung nur Rechnungen liest: Er zeigt nur lastMonth.
groups[].quantitiesArray<object>Die Nutzung je Zähler. Token-gemessene Positionen: input_tokens, output_tokens, cached_input_tokens, cache_write_tokens, batch_input_tokens, batch_output_tokens, images, audio_seconds, embeddings_tokens oder requests. Kapazitätspositionen: gpu_hours, ptu_hours, model_units_hours oder cluster_hours. other für eine Position, die Pleaxy noch keinem Zähler zugeordnet hat. unit ist die Einheit der Menge: 1M_tokens, tokens, requests, images, seconds, gpu_hours, ptu_hours, model_unit_hours oder units für eine nicht zugeordnete Position.
groups[].purchaseOrdersArray<object>Die offenen Bestellpositionen an den Rechnungssteller der Gruppe, mit dem, was auf jeder noch übrig ist (remaining, in der Währung der Gruppe), nach den bereits darauf gebuchten Rechnungen. Nur bei einer Gruppe mit Rechnungssteller.
groups[].servicesArray<object>Nur bei groupBy invoicer: die Zahlen der Gruppe je eigenem Service des Anbieters (Amazon Bedrock, mit den Marketplace-Modellen, die es abrechnet; Amazon SageMaker; Vertex AI; ...), wie der Tab Cloud der Seite Ausgaben sie zeigt.
unattributedArray<object>Nur bei groupBy costCenter: die Ausgaben, auf die keine Zuordnungsregel passte, ein Eintrag je Währung in der Form einer Gruppe, angezeigt und nie ausgeblendet. Schreiben Sie dafür eine Regel mit SetAiAttribution.
notReadableArray<object>Verbundene Konten ohne KI-Positionen und der Grund: needs_current_cost für ein AWS-Konto, dessen Verbindung keine aktuellen Kosten erlaubt (AWS liefert seine KI-Positionen nur über Cost Explorer), not_synced_yet für eines, dessen KI-Positionen noch nicht gelesen wurden. Fehlt, wenn es keine gibt.
Fehler
- 400 Bad Request - period ist kein Monat im Format YYYY-MM, oder groupBy ist weder invoicer, vendor, model noch costCenter.
- 401 Unauthorized - Es wurden keine Zugangsdaten übermittelt, oder der Bearer-Token bzw. der X-Api-Key-Wert fehlt, ist ungültig, abgelaufen oder widerrufen.
- 403 Forbidden - Der Bearer-Token oder API-Schlüssel des Aufrufers gewährt keinen Zugriff auf diesen Workspace (regionId) oder hat nicht die erforderliche Rolle.
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 } ]
}
]
}