Recupera l'analisi del consumo
curl --request GET \
--url https://server.codeium.com/api/v2alpha/analytics/consumption \
--header 'Authorization: Bearer <token>'import requests
url = "https://server.codeium.com/api/v2alpha/analytics/consumption"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://server.codeium.com/api/v2alpha/analytics/consumption', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://server.codeium.com/api/v2alpha/analytics/consumption",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v2alpha/analytics/consumption"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://server.codeium.com/api/v2alpha/analytics/consumption")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v2alpha/analytics/consumption")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"timestamp": "2026-06-15T00:00:00.000Z",
"user_id": "user_abc123",
"user_email": "alice@example.com",
"consumption": {
"prompt_credits": 1250,
"flex_credits": 340,
"message_count": 87,
"user_message_count": 31
}
},
{
"timestamp": "2026-06-15T00:00:00.000Z",
"user_id": "user_def456",
"user_email": "bob@example.com",
"consumption": {
"prompt_credits": 980,
"flex_credits": 150,
"message_count": 52,
"user_message_count": 19
}
}
],
"pagination": {
"next_page_cursor": null
},
"metadata": {
"billing_strategy": "CREDITS",
"data_freshness": "2026-06-16T03:00:00.000Z",
"query_time_ms": 1423,
"team_id": "team_abc123"
}
}API di analisi
Recupera il consumo
Interroga i dati di analisi del consumo di crediti, ACU o token con filtri, raggruppamenti e paginazione flessibili.
GET
/
api
/
v2alpha
/
analytics
/
consumption
Recupera l'analisi del consumo
curl --request GET \
--url https://server.codeium.com/api/v2alpha/analytics/consumption \
--header 'Authorization: Bearer <token>'import requests
url = "https://server.codeium.com/api/v2alpha/analytics/consumption"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://server.codeium.com/api/v2alpha/analytics/consumption', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://server.codeium.com/api/v2alpha/analytics/consumption",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v2alpha/analytics/consumption"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://server.codeium.com/api/v2alpha/analytics/consumption")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v2alpha/analytics/consumption")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"timestamp": "2026-06-15T00:00:00.000Z",
"user_id": "user_abc123",
"user_email": "alice@example.com",
"consumption": {
"prompt_credits": 1250,
"flex_credits": 340,
"message_count": 87,
"user_message_count": 31
}
},
{
"timestamp": "2026-06-15T00:00:00.000Z",
"user_id": "user_def456",
"user_email": "bob@example.com",
"consumption": {
"prompt_credits": 980,
"flex_credits": 150,
"message_count": 52,
"user_message_count": 19
}
}
],
"pagination": {
"next_page_cursor": null
},
"metadata": {
"billing_strategy": "CREDITS",
"data_freshness": "2026-06-16T03:00:00.000Z",
"query_time_ms": 1423,
"team_id": "team_abc123"
}
}Questo è un endpoint v2 che utilizza l’autenticazione tramite token Bearer e parametri di query, a differenza dell’API di analisi v1, che utilizza chiavi di servizio nel corpo della richiesta. Vedi Autenticazione di seguito.
Questo endpoint non è pensato per il monitoraggio dell’utilizzo in tempo reale. I dati vengono aggregati su base oraria e il
limite di frequenza è basso (10 richieste all’ora per team). Usalo per report periodici ed esportazioni in blocco.
Autenticazione
Questo endpoint utilizza l’autenticazione tramite token Bearer. Includi il tuo token nell’headerAuthorization:
Authorization: Bearer <your_token>
Strategia di fatturazione
La struttura della risposta dipende dalla strategia di fatturazione del tuo team:| Strategia | Campi popolati | Descrizione |
|---|---|---|
ACU | billed_acus | Fatturazione Devin enterprise Standard, condivisa con Devin Cloud |
CREDITS | prompt_credits, flex_credits | Aziende con legacy Windsurf enterprise |
DOLLARS | tokens | Team selezionati con fatturazione granulare dei token abilitata (vedi Utilizzo dei token) |
message_count e user_message_count (all’interno di consumption) vengono restituiti indipendentemente dalla
strategia di fatturazione. user_message_count conta solo i messaggi inviati da un utente all’agente, da qualsiasi client (Devin
Desktop, il plugin JetBrains o la CLI); corrisponde al valore “messaggi inviati” nella UI di analytics.
message_count conta ogni evento di fatturazione, incluse le successive richieste al modello e agli strumenti all’interno di ciascun turn. user_message_count è null per le righe prive di
attribuzione ai messaggi utente (utilizzo precedente all’11/04/2026).
Utilizzo dei token
Per i team con la fatturazione granulare dei token abilitata (DOLLARS), ogni riga include anche un oggetto tokens con i
conteggi dei token relativi a quella riga. Usa gli stessi valori di granularity e group_by di consumption, quindi raggruppando per
session si ottengono i totali dei token per singola sessione.
| Campo | Descrizione |
|---|---|
input_tokens | Token di input non presenti in cache. Non include le letture e le scritture in cache. |
cache_read_tokens | Token di input letti dalla cache dei prompt del fornitore del modello. |
cache_write_tokens | Token di input scritti nella cache dei prompt del fornitore del modello. |
output_tokens | Token di output. |
input_tokens + cache_read_tokens + cache_write_tokens. L’utilizzo precedente all’introduzione della registrazione dei conteggi dei token
per questo endpoint viene conteggiato come 0. I team non fatturati a token e
le richieste autenticate con una chiave di servizio Windsurf non ricevono l’oggetto tokens; le richieste con service-key Windsurf
restituiscono la strategia e i campi CREDITS o ACU del team anziché DOLLARS.
Per queste organizzazioni, metadata.billing_strategy è DOLLARS e consumption contiene solo message_count e user_message_count: i campi relativi a crediti e ACU
(prompt_credits, flex_credits, billed_acus) vengono omessi.
Raggruppamento e granularità
Usagranularity e group_by per controllare la forma dei dati restituiti:
- Nessuna granularità o raggruppamento — restituisce una singola riga aggregata per l’intero intervallo di date
granularity=daily— ogni riga include untimestampnel formatoYYYY-MM-DDgranularity=monthly— ogni riga include untimestampnel formatoYYYY-MMgroup_by=user— ogni riga include unuser_ideuser_emailgroup_by=session— ogni riga include unsession_idgroup_by=user,model_uid— ogni riga includeuser_id,user_emailemodel_uidgroup_by=ide— ogni riga include unidegroup_by=ide,ide_version— ogni riga includeideeide_version(il raggruppamento peride_versionrichiede che sia incluso ancheide)group_by=os— ogni riga include unos, comedarwin(macOS),windowsolinux
Per misurare ciò che l’agente ha prodotto anziché ciò che ha consumato, usa
Get Output (
metric=loc_inserted,loc_deleted), che restituisce
le righe di codice accettate con gli stessi filtri e le stesse dimensioni di raggruppamento.Paginazione
I risultati sono paginati con una dimensione predefinita della pagina di 1.000 righe (max 10.000). Quando sono disponibili altri risultati, la risposta include unnext_page_cursor nell’oggetto pagination. Passalo come parametro di query page_cursor
per recuperare la pagina successiva.
I cursori di pagina scadono dopo 24 ore. Una richiesta per la pagina successiva non viene conteggiata come una nuova query ai fini del rate limit.
Limiti di frequenza
Questo endpoint è soggetto a un limite di 10 richieste all’ora per team. Se questo limite viene superato, il server restituisce429 Too Many Requests con un header Retry-After.
La paginazione di una query precedente (seguendo un next_page_cursor) non viene conteggiata ai fini di questo limite —
viene conteggiata solo la query iniziale per ciascun report. Questo limite ridotto riflette il fatto che l’endpoint è pensato per
report periodici, non per il monitoraggio dell’utilizzo in tempo reale.Autorizzazioni
Una chiave di servizio con autorizzazione Analisi Read, passata come token Bearer nell'header Authorization.
Crea una chiave di servizio nelle impostazioni del team, nella sezione "Service Keys".
Parametri della query
Elenco di dimensioni separate da virgole in base a cui raggruppare i risultati. Dimensioni supportate:
user— includeuser_ideuser_emailin ogni rigamodel_uid— includemodel_uidin ogni rigaide— includeidein ogni rigaide_version— includeide_versionin ogni riga; richiede che sia incluso ancheideos— includeosin ogni riga

