> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Obtenir les métriques d'utilisation des caractères GET https://api.elevenlabs.io/v1/usage/character-stats (Obsolète) Ce point de terminaison est obsolète. Utilisez plutôt /v1/workspace/analytics/query/usage-by-product-over-time, qui expose la taille du compartiment sous la forme de `interval_seconds` (un entier en secondes) plutôt que `aggregation_interval`. Renvoie les métriques d’utilisation de l’utilisateur actuel ou de l’ensemble du Workspace auquel il appartient. La réponse fournit un axe temporel basé sur l’intervalle d’agrégation spécifié (par défaut : jour), avec les valeurs d’utilisation pour chaque intervalle de cet axe. L’utilisation est ventilée selon le type de ventilation sélectionné. Par exemple, le type de ventilation « voice » renvoie l’utilisation de chaque voix pour chaque intervalle de l’axe temporel. Reference: https://elevenlabs.io/docs/api-reference/legacy/usage/get ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Query parameters - `start_unix` (integer, required) — Horodatage Unix UTC du début de la période d’utilisation, en millisecondes. Pour inclure le premier jour de la période, l’horodatage doit correspondre à 00:00:00 ce jour-là. - `end_unix` (integer, required) — Horodatage Unix UTC de la fin de la période d’utilisation, en millisecondes. Pour inclure le dernier jour de la période, l’horodatage doit correspondre à 23:59:59 ce jour-là. - `include_workspace_metrics` (boolean, optional, default: false) — Indique si les statistiques de l’ensemble du Workspace doivent être incluses. - `breakdown_type` (enum, optional) — Méthode de ventilation des informations. Ne peut pas être "user" si include_workspace_metrics est False. - Allowed values: `none`, `voice`, `voice_multiplier`, `user`, `groups`, `api_keys`, `all_api_keys`, `product_type`, `model`, `resource`, `request_queue`, `region`, `subresource_id`, `reporting_workspace_id`, `has_api_key`, `request_source` - `aggregation_interval` (enum, optional) — Méthode d’agrégation des données d’utilisation au fil du temps. Peut être "hour", "day", "week", "month" ou "cumulative". - Allowed values: `hour`, `day`, `week`, `month`, `cumulative` - `aggregation_bucket_size` (integer, optional, nullable) — Taille de l'intervalle d'agrégation en secondes. Remplace l'intervalle d'agrégation. - `metric` (enum, optional) — Indique la métrique à agréger. - Allowed values: `credits`, `tts_characters`, `minutes_used`, `request_count`, `ttfb_avg`, `ttfb_p95`, `fiat_units_spent`, `concurrency`, `concurrency_average` ## Response ### 200 Réponse réussie - `time` (list of integer, required) — L’axe temporel avec les horodatages Unix de chaque jour. - `usage` (map from string to list of double, required) — L’utilisation de chaque type de répartition sur l’axe temporel. ## Errors ### 422 Unprocessable Entity Error Erreur de validation - `detail` (list of ValidationError, optional) ## Types ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ValidationErrorLocItems - string - integer ## Examples **Response** ```json { "time": [ 1738252091000, 1739404800000 ], "usage": { "All": [ 49, 1053 ] } } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/usage/character-stats" querystring = {"end_unix":"1688165999","start_unix":"1685574000"} response = requests.get(url, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000") .asString(); ``` ```php request('GET', 'https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/usage/character-stats?end_unix=1688165999&start_unix=1685574000")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```