Beta: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.
Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.
{
"error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}
{
"error": "<string>"
}
{
"error": "<string>"
}
Il s’agit d’un endpoint en beta qui peut être instable ou changer sans préavis.
Obtenez des analyses d’utilisation agrégées pour l’utilisateur authentifié, avec des ventilations par date, modèle et clé API. Cet endpoint fournit des vues récapitulatives de vos données d’utilisation de l’API pour construire des tableaux de bord et surveiller la consommation. Les données sont mises en cache pendant 10 minutes.
Vous pouvez spécifier la période d’analyse en utilisant soit :
lookback : Une période relative comme “7d” (7 jours), “30d” (30 jours), jusqu’à “90d” (90 jours)
startDate et endDate : Une plage de dates personnalisée au format YYYY-MM-DD. Envoyez les deux pour utiliser une plage personnalisée.
Si aucun paramètre n’est spécifié, la période de lookback par défaut est de 7 jours.
Si vous n’envoyez que startDate ou endDate, la requête n’échoue pas : elle renvoie 200 en utilisant le lookback par défaut de 7 jours et ignore la date, sans aucun avertissement. Envoyez toujours les deux ensemble.Un lookback supérieur à 90 jours est plafonné à 90d. Une plage startDate/endDate supérieure à 90 jours renvoie 400.
Données de graphique quotidiennes pour les 8 meilleurs modèles. Chaque entrée contient une “date” (horodatage) plus les noms des modèles comme clés avec les valeurs d’utilisation DIEM.
Données de graphique quotidiennes pour les 8 meilleures clés API. Chaque entrée contient une “date” (horodatage) plus les descriptions de clé comme clés avec les valeurs d’utilisation DIEM.
# Obtenir les analyses d'utilisation des 7 derniers jours (par défaut)curl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics" \ -H "Authorization: Bearer YOUR_API_KEY"# Obtenir les analyses d'utilisation des 30 derniers jourscurl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics?lookback=30d" \ -H "Authorization: Bearer YOUR_API_KEY"# Obtenir les analyses d'utilisation pour une plage de dates spécifiquecurl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics?startDate=2024-01-01&endDate=2024-01-31" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}
{
"error": "<string>"
}
{
"error": "<string>"
}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Venice API Docs","colors":{"primary":"#125DA3","light":"#4898E6","dark":"#125DA3"},"logo":{"light":"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c","dark":"https://mintcdn.com/veniceai/0vNwudF9KfvWPUSs/logo/dark.svg?fit=max\u0026auto=format\u0026n=0vNwudF9KfvWPUSs\u0026q=85\u0026s=79383337fb486ba06afb95cb7d0b4bf7","href":"https://venice.ai/?utm_source=venice-api-documentation"},"favicon":"https://mintcdn.com/veniceai/wJjdz14nrhedln0s/favicon.png?fit=max\u0026auto=format\u0026n=wJjdz14nrhedln0s\u0026q=85\u0026s=171a8dd0d43182f3b386c25e13152d92","api":{"openapi":"swagger.yaml","playground":{"proxy":false},"mdx":{"auth":{"method":"bearer"},"server":"https://api.venice.ai/api/v1"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#0E1217"}},"navbar":{"links":[],"primary":{"type":"button","label":"Try Venice","href":"https://venice.ai/chat?utm_source=venice-api-documentation"}},"footer":{"socials":{"x":"https://x.com/AskVenice","discord":"https://discord.gg/askvenice","github":"https://github.com/veniceai","linkedin":"https://www.linkedin.com/company/venice-ai"}},"seo":{"metatags":{"og:site_name":"Venice API Docs","og:locale":"en_US","og:logo":"/logo/light.svg","article:publisher":"Venice AI","twitter:site":"@AskVenice"},"indexing":"navigable"},"icons":{"library":"tabler"},"styling":{"codeblocks":"system","latex":true},"integrations":{"gtm":{"tagId":"GTM-KFP6HX49"},"plausible":{"domain":"docs.venice.ai"}},"navigation":{"languages":[{"language":"en","default":true,"href":"overview/about-venice"},{"language":"pt-BR","href":"pt-BR/overview/about-venice"},{"language":"ar","href":"ar/overview/about-venice"},{"language":"it","href":"it/overview/about-venice"},{"language":"de","href":"de/overview/about-venice"},{"language":"es","href":"es/overview/about-venice"},{"language":"fr","href":"fr/overview/about-venice"},{"language":"zh","href":"zh/overview/about-venice"},{"language":"ko","href":"ko/overview/about-venice"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"veniceai","hasAudioNarration":false,"actualSubdomain":"veniceai","customDomains":["docs.venice.ai"],"gitSource":{"type":"github","owner":"veniceai","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aebf65c6c2706dc57ad60a8","collectionId":"abf17d6b-36a1-4a01-9008-0ea7c7298670","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aebf65c6c2706dc57ad60a8"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aebf65c6c2706dc57ad60a8","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"en","tag":"Models","count":558},{"language":"ar","tag":"النماذج","count":558},{"language":"de","tag":"Modelle","count":558},{"language":"es","tag":"Modelos","count":558},{"language":"fr","tag":"Modèles","count":558},{"language":"it","tag":"Modelli","count":558},{"language":"ko","tag":"모델","count":558},{"language":"pt-BR","tag":"Modelos","count":558},{"language":"zh","tag":"模型","count":558},{"language":"en","tag":"Docs","count":80},{"language":"ar","tag":"التوثيق","count":80},{"language":"de","tag":"Dokumentation","count":80},{"language":"es","tag":"Documentación","count":80},{"language":"fr","tag":"Documentation","count":80},{"language":"it","tag":"Documentazione","count":80},{"language":"ko","tag":"문서","count":80},{"language":"pt-BR","tag":"Documentação","count":80},{"language":"zh","tag":"文档","count":80},{"language":"en","tag":"API Reference","count":58},{"language":"en","tag":"Venice APIs","count":58},{"language":"ar","tag":"مرجع الـ API","count":58},{"language":"ar","tag":"Venice APIs","count":58},{"language":"de","tag":"API-Referenz","count":58},{"language":"de","tag":"Venice APIs","count":58},{"language":"es","tag":"Referencia de la API","count":58},{"language":"es","tag":"Venice APIs","count":58},{"language":"fr","tag":"Référence de l'API","count":58},{"language":"fr","tag":"Venice APIs","count":58},{"language":"it","tag":"Riferimento API","count":58},{"language":"it","tag":"Venice APIs","count":58},{"language":"ko","tag":"API 레퍼런스","count":58},{"language":"ko","tag":"Venice APIs","count":58},{"language":"pt-BR","tag":"Referência da API","count":58},{"language":"pt-BR","tag":"Venice APIs","count":58},{"language":"zh","tag":"API 参考","count":58},{"language":"zh","tag":"Venice APIs","count":58},{"language":"en","tag":"Audio","count":18},{"language":"en","tag":"Learn","count":18},{"language":"ar","tag":"الصوت","count":18},{"language":"ar","tag":"تعلّم","count":18},{"language":"de","tag":"Audio","count":18},{"language":"de","tag":"Lernen","count":18},{"language":"es","tag":"Audio","count":18},{"language":"es","tag":"Aprender","count":18},{"language":"fr","tag":"Audio","count":18},{"language":"fr","tag":"Apprendre","count":18},{"language":"it","tag":"Audio","count":18},{"language":"it","tag":"Impara","count":18},{"language":"ko","tag":"오디오","count":18},{"language":"ko","tag":"학습","count":18},{"language":"pt-BR","tag":"Áudio","count":18},{"language":"pt-BR","tag":"Aprender","count":18},{"language":"zh","tag":"音频","count":18},{"language":"zh","tag":"学习","count":18},{"language":"it","tag":"Immagini","count":12},{"language":"ko","tag":"이미지","count":12},{"language":"zh","tag":"图像","count":12},{"language":"en","tag":"Text \u0026 Chat","count":11},{"language":"ar","tag":"النص والدردشة","count":11},{"language":"de","tag":"Text \u0026 Chat","count":11},{"language":"es","tag":"Texto y chat","count":11},{"language":"fr","tag":"Texte et chat","count":11},{"language":"it","tag":"Testo e chat","count":11},{"language":"ko","tag":"텍스트 및 채팅","count":11},{"language":"pt-BR","tag":"Texto e chat","count":11},{"language":"zh","tag":"文本与聊天","count":11},{"language":"en","tag":"Agents \u0026 Integrations","count":10},{"language":"ar","tag":"الوكلاء والتكاملات","count":10},{"language":"de","tag":"Agenten \u0026 Integrationen","count":10},{"language":"es","tag":"Agentes e integraciones","count":10},{"language":"fr","tag":"Agents et intégrations","count":10},{"language":"it","tag":"Agenti e integrazioni","count":10},{"language":"ko","tag":"에이전트 및 통합","count":10},{"language":"pt-BR","tag":"Agentes e integrações","count":10},{"language":"zh","tag":"智能体与集成","count":10},{"language":"en","tag":"Video","count":9},{"language":"ar","tag":"الفيديو","count":9},{"language":"de","tag":"Video","count":9},{"language":"es","tag":"Vídeo","count":9},{"language":"fr","tag":"Vidéo","count":9},{"language":"it","tag":"Video","count":9},{"language":"ko","tag":"비디오","count":9},{"language":"pt-BR","tag":"Vídeo","count":9},{"language":"zh","tag":"视频","count":9},{"language":"en","tag":"Coding Tools","count":8},{"language":"ar","tag":"أدوات البرمجة","count":8},{"language":"de","tag":"Coding-Tools","count":8},{"language":"es","tag":"Herramientas de código","count":8},{"language":"fr","tag":"Outils de code","count":8},{"language":"pt-BR","tag":"Ferramentas de código","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/veniceai/c65ef92b6a27d6fc/style.css"},{"filePath":"model-hub.css","href":"/_mintlify/custom/veniceai/fffafbff731f63e2/model-hub.css"}],"page":{"pagePath":"fr/api-reference/endpoint/billing/usage-analytics","slug":"/fr/api-reference/endpoint/billing/usage-analytics","pageMetadata":{"title":"Analyses d'utilisation de facturation (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Analyses d'utilisation de facturation | Venice API Docs","og:description":"Obtenez des analyses d'utilisation agrégées avec des ventilations par date, modèle et clé API.","description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","href":"/fr/api-reference/endpoint/billing/usage-analytics"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Beta\"\n }), \": This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsx(_components.p,{children:`Il s’agit d’un endpoint en beta qui peut être instable ou changer sans préavis.`})}),`\n`,_jsx(_components.p,{children:`Obtenez des analyses d’utilisation agrégées pour l’utilisateur authentifié, avec des ventilations par date, modèle et clé API. Cet endpoint fournit des vues récapitulatives de vos données d’utilisation de l’API pour construire des tableaux de bord et surveiller la consommation. Les données sont mises en cache pendant 10 minutes.`}),`\n`,_jsx(Heading,{level:`2`,id:`paramètres-de-requête`,children:`Paramètres de requête`}),`\n`,_jsx(_components.p,{children:`Vous pouvez spécifier la période d’analyse en utilisant soit :`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`lookback`}),` : Une période relative comme “7d” (7 jours), “30d” (30 jours), jusqu’à “90d” (90 jours)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`startDate`}),` et `,_jsx(_components.strong,{children:`endDate`}),` : Une plage de dates personnalisée au format `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. Envoyez les deux pour utiliser une plage personnalisée.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Si aucun paramètre n’est spécifié, la période de lookback par défaut est de 7 jours.`}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Si vous n’envoyez que `,_jsx(_components.code,{children:`startDate`}),` ou `,_jsx(_components.code,{children:`endDate`}),`, la requête n’échoue pas : elle renvoie `,_jsx(_components.code,{children:`200`}),` en utilisant le lookback par défaut de 7 jours et ignore la date, sans aucun avertissement. Envoyez toujours les deux ensemble.`]}),_jsxs(_components.p,{children:[`Un `,_jsx(_components.code,{children:`lookback`}),` supérieur à 90 jours est plafonné à `,_jsx(_components.code,{children:`90d`}),`. Une plage `,_jsx(_components.code,{children:`startDate`}),`/`,_jsx(_components.code,{children:`endDate`}),` supérieure à 90 jours renvoie `,_jsx(_components.code,{children:`400`}),`.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`champs-de-la-réponse`,children:`Champs de la réponse`}),`\n`,_jsx(Heading,{level:`3`,id:`lookback`,children:`lookback`}),`\n`,_jsx(_components.p,{children:`La période de lookback utilisée pour la requête. Soit au format “Nd” (par exemple “7d”), soit au format “startDate:endDate”.`}),`\n`,_jsx(Heading,{level:`3`,id:`bydate`,children:`byDate`}),`\n`,_jsx(_components.p,{children:`Totaux d’utilisation quotidienne pour la période demandée.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`date`}),` : La date au format `,_jsx(_components.code,{children:`YYYY-MM-DD`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`USD`}),` : Utilisation totale en USD pour ce jour`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`DIEM`}),` : Utilisation totale en DIEM pour ce jour`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodel`,children:`byModel`}),`\n`,_jsx(_components.p,{children:`Ventilation de l’utilisation par modèle, triée par dépense totale (la plus élevée d’abord).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelName`}),` : Nom d’affichage du modèle (par exemple “GLM 5”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`unitType`}),` : Type d’unités consommées (tokens, images, chars, minutes, seconds)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelType`}),` : Type de modèle (LLM, IMAGE, TTS, ASR, VIDEO), ou null`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),` : Total USD dépensé sur ce modèle`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),` : Total DIEM dépensé sur ce modèle`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),` : Unités totales consommées pour ce modèle`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`breakdown`}),` : Tableau des ventilations d’utilisation par type (uniquement présent si plusieurs types). Chaque entrée contient :`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`type`}),` : Type de token (par exemple “Input”, “Output”, “Cache Read”, “Cache Write”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`usd`}),` : Montant en USD pour cette ventilation`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`diem`}),` : Montant en DIEM pour cette ventilation`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`units`}),` : Nombre d’unités pour cette ventilation`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodeldaily`,children:`byModelDaily`}),`\n`,_jsx(_components.p,{children:`Données de graphique quotidiennes pour les 8 meilleurs modèles. Chaque entrée contient une “date” (horodatage) plus les noms des modèles comme clés avec les valeurs d’utilisation DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topmodels`,children:`topModels`}),`\n`,_jsx(_components.p,{children:`Tableau des 8 meilleurs noms de modèles par utilisation, pour les légendes de graphique.`}),`\n`,_jsx(Heading,{level:`3`,id:`bykey`,children:`byKey`}),`\n`,_jsx(_components.p,{children:`Ventilation de l’utilisation par clé API, triée par dépense totale (la plus élevée d’abord).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`apiKeyId`}),` : L’ID de la clé API, ou null si l’utilisation provenait de l’application web`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`description`}),` : Description de la clé API ou “Web App”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),` : Total USD dépensé via cette clé`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),` : Total DIEM dépensé via cette clé`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),` : Unités totales consommées via cette clé`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bykeydaily`,children:`byKeyDaily`}),`\n`,_jsx(_components.p,{children:`Données de graphique quotidiennes pour les 8 meilleures clés API. Chaque entrée contient une “date” (horodatage) plus les descriptions de clé comme clés avec les valeurs d’utilisation DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topkeynames`,children:`topKeyNames`}),`\n`,_jsx(_components.p,{children:`Tableau des 8 meilleures descriptions de clé API par utilisation, pour les légendes de graphique.`}),`\n`,_jsx(Heading,{level:`2`,id:`exemple-d’utilisation`,children:`Exemple d’utilisation`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Obtenir les analyses d'utilisation des 7 derniers jours (par défaut)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.venice.ai/api/v1/billing/usage-analytics\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Obtenir les analyses d'utilisation des 30 derniers jours`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.venice.ai/api/v1/billing/usage-analytics?lookback=30d\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Obtenir les analyses d'utilisation pour une plage de dates spécifique`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.venice.ai/api/v1/billing/usage-analytics?startDate=2024-01-01\u0026endDate=2024-01-31\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Analyses d'utilisation de facturation (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Analyses d'utilisation de facturation | Venice API Docs","og:description":"Obtenez des analyses d'utilisation agrégées avec des ventilations par date, modèle et clé API.","description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","href":"/fr/api-reference/endpoint/billing/usage-analytics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Paramètres de requête","slug":"paramètres-de-requête","depth":2,"children":[]},{"title":"Champs de la réponse","slug":"champs-de-la-réponse","depth":2,"children":[{"title":"lookback","slug":"lookback","depth":3,"children":[]},{"title":"byDate","slug":"bydate","depth":3,"children":[]},{"title":"byModel","slug":"bymodel","depth":3,"children":[]},{"title":"byModelDaily","slug":"bymodeldaily","depth":3,"children":[]},{"title":"topModels","slug":"topmodels","depth":3,"children":[]},{"title":"byKey","slug":"bykey","depth":3,"children":[]},{"title":"byKeyDaily","slug":"bykeydaily","depth":3,"children":[]},{"title":"topKeyNames","slug":"topkeynames","depth":3,"children":[]}]},{"title":"Exemple d’utilisation","slug":"exemple-d’utilisation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/veniceai/e2ef95b7f404dd19/model-search.js"],"openApiReferenceData":{"operation":{"description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","operationId":"getBillingUsageAnalytics","summary":"/api/v1/billing/usage-analytics","tags":["Billing"],"parameters":["eee05a00-9018-43fe-b66b-ed1ad7ed7915","c7163522-89b0-4825-a39b-37bcad5aa5a5","4b4718b7-6061-469a-8ddf-b9a857eddffa"],"responses":{"200":"bde3c2b0-999c-4343-aad7-ba6731aac536","400":"1a6063a4-1135-49bc-8826-3826b8ac3fc8","401":"425dfa5f-8ba5-422b-a47c-211d02b1c4ae","403":"8635f966-1132-4f65-be43-2c2585d5ec30","500":"99df9149-3373-4fac-a557-6502dd40942e","504":"59f87729-5f45-40fa-ac2a-b71f0687af14"},"method":"get","type":"path","servers":["96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d"],"security":["5ae61ed6-c925-4e36-a3b5-59b7cd2707f3"],"path":"/billing/usage-analytics","baseUrlOptions":["https://api.venice.ai/api/v1"],"title":"/api/v1/billing/usage-analytics","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"eee05a00-9018-43fe-b66b-ed1ad7ed7915":{"schema":{"type":"string","pattern":"^[1-9]\\d*d$","default":"7d","description":"Lookback period for usage data. Format: number followed by \"d\" (e.g., \"7d\", \"30d\"). Maximum: 90d","example":"7d","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"lookback","in":"query"},"c7163522-89b0-4825-a39b-37bcad5aa5a5":{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date for filtering records (YYYY-MM-DD). If provided, endDate is also required.","example":"2024-01-01T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"startDate","in":"query"},"4b4718b7-6061-469a-8ddf-b9a857eddffa":{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date for filtering records (YYYY-MM-DD). If provided, startDate is also required.","example":"2024-01-31T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"endDate","in":"query"}},"responses":{"bde3c2b0-999c-4343-aad7-ba6731aac536":{"description":"Successful response with aggregated usage analytics","content":{"application/json":{"schema":{"type":"object","properties":{"lookback":{"type":"string","description":"The lookback period used for the query. Either \"Nd\" format or \"startDate:endDate\" format.","example":"7d","isRequired":true,"uniqueKey":"lookback","typeLabel":"string"},"byDate":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format","example":"2024-01-15T00:00:00.000Z","isRequired":true,"uniqueKey":"byDate.items.[INDEX].date","typeLabel":"string"},"USD":{"type":"number","description":"Total USD usage for this date","isRequired":true,"uniqueKey":"byDate.items.[INDEX].USD","typeLabel":"number"},"DIEM":{"type":"number","description":"Total DIEM usage for this date","isRequired":true,"uniqueKey":"byDate.items.[INDEX].DIEM","typeLabel":"number"}},"required":["date","USD","DIEM"],"uniqueKey":"byDate.items.[INDEX]","typeLabel":"object"},"description":"Daily usage totals for the requested period","isRequired":true,"uniqueKey":"byDate","typeLabel":"object[]"},"byModel":{"type":"array","items":{"type":"object","properties":{"modelName":{"type":"string","description":"Display name of the model","example":"GLM 5.1","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelName","typeLabel":"string"},"unitType":{"type":"string","description":"Type of units (tokens, images, chars, minutes, seconds)","example":"tokens","isRequired":true,"uniqueKey":"byModel.items.[INDEX].unitType","typeLabel":"string"},"modelType":{"oneOf":[{"type":"string","description":"Type of model (LLM, IMAGE, TTS, ASR, VIDEO)","example":"LLM","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of model (LLM, IMAGE, TTS, ASR, VIDEO)","example":"LLM","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType","typeLabel":"string | null"},"totalUsd":{"type":"number","description":"Total USD usage for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalUsd","typeLabel":"number"},"totalDiem":{"type":"number","description":"Total DIEM usage for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalDiem","typeLabel":"number"},"totalUnits":{"type":"number","description":"Total units consumed for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalUnits","typeLabel":"number"},"breakdown":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Token type (e.g., \"Input\", \"Output\", \"Cache Read\", \"Cache Write\")","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].type","typeLabel":"string"},"usd":{"type":"number","description":"USD amount for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].usd","typeLabel":"number"},"diem":{"type":"number","description":"DIEM amount for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].diem","typeLabel":"number"},"units":{"type":"number","description":"Number of units for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].units","typeLabel":"number"}},"required":["type","usd","diem","units"],"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX]","typeLabel":"object"},"description":"Breakdown by token type (only present if multiple types)","uniqueKey":"byModel.items.[INDEX].breakdown","typeLabel":"object[]"}},"required":["modelName","unitType","modelType","totalUsd","totalDiem","totalUnits"],"uniqueKey":"byModel.items.[INDEX]","typeLabel":"object"},"description":"Usage breakdown by model, sorted by total spend (highest first)","isRequired":true,"uniqueKey":"byModel","typeLabel":"object[]"},"byModelDaily":{"type":"array","items":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"byModelDaily.items.[INDEX].additionalProperties","typeLabel":"number"},"uniqueKey":"byModelDaily.items.[INDEX]","typeLabel":"object"},"description":"Daily chart data for top 8 models. Each entry has \"date\" (timestamp) plus model names as keys.","isRequired":true,"uniqueKey":"byModelDaily","typeLabel":"object[]"},"topModels":{"type":"array","items":{"type":"string","uniqueKey":"topModels.items.[INDEX]","typeLabel":"string"},"description":"Names of the top 8 models by usage (for chart legends)","isRequired":true,"uniqueKey":"topModels","typeLabel":"string[]"},"byKey":{"type":"array","items":{"type":"object","properties":{"apiKeyId":{"oneOf":[{"type":"string","description":"API key ID, or null if usage was from web app","isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId.oneOf.0","typeLabel":"string"},{"type":"null","description":"API key ID, or null if usage was from web app","isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId","typeLabel":"string | null"},"description":{"type":"string","description":"API key description or \"Web App\"","example":"My Production Key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].description","typeLabel":"string"},"totalUsd":{"type":"number","description":"Total USD usage for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalUsd","typeLabel":"number"},"totalDiem":{"type":"number","description":"Total DIEM usage for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalDiem","typeLabel":"number"},"totalUnits":{"type":"number","description":"Total units consumed for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalUnits","typeLabel":"number"}},"required":["apiKeyId","description","totalUsd","totalDiem","totalUnits"],"uniqueKey":"byKey.items.[INDEX]","typeLabel":"object"},"description":"Usage breakdown by API key, sorted by total spend (highest first)","isRequired":true,"uniqueKey":"byKey","typeLabel":"object[]"},"byKeyDaily":{"type":"array","items":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"byKeyDaily.items.[INDEX].additionalProperties","typeLabel":"number"},"uniqueKey":"byKeyDaily.items.[INDEX]","typeLabel":"object"},"description":"Daily chart data for top 8 API keys. Each entry has \"date\" (timestamp) plus key descriptions as keys.","isRequired":true,"uniqueKey":"byKeyDaily","typeLabel":"object[]"},"topKeyNames":{"type":"array","items":{"type":"string","uniqueKey":"topKeyNames.items.[INDEX]","typeLabel":"string"},"description":"Descriptions of the top 8 API keys by usage (for chart legends)","isRequired":true,"uniqueKey":"topKeyNames","typeLabel":"string[]"}},"required":["lookback","byDate","byModel","byModelDaily","topModels","byKey","byKeyDaily","topKeyNames"],"additionalProperties":false,"description":"Aggregated usage analytics response with breakdowns by date, model, and API key","example":{"lookback":"7d","byDate":[{"date":"2024-01-15T00:00:00.000Z","USD":0.5,"DIEM":10.25},{"date":"2024-01-14T00:00:00.000Z","USD":0.3,"DIEM":8.75}],"byModel":[{"modelName":"GLM 5.1","unitType":"tokens","modelType":"LLM","totalUsd":0.4,"totalDiem":12.5,"totalUnits":50000,"breakdown":[{"type":"Output","usd":0.3,"diem":10,"units":35000},{"type":"Input","usd":0.1,"diem":2.5,"units":15000}]}],"byModelDaily":[{"date":1705276800000,"GLM 5.1":5.5,"Kimi K2.6":3.2}],"topModels":["GLM 5.1","Kimi K2.6"],"byKey":[{"apiKeyId":"key_abc123","description":"Production Key","totalUsd":0.8,"totalDiem":15,"totalUnits":75000},{"apiKeyId":null,"description":"Web App","totalUsd":0,"totalDiem":4,"totalUnits":25000}],"byKeyDaily":[{"date":1705276800000,"Production Key":8.5,"Web App":2}],"topKeyNames":["Production Key","Web App"]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"lookback":"7d","byDate":[{"date":"2024-01-15T00:00:00.000Z","USD":0.5,"DIEM":10.25},{"date":"2024-01-14T00:00:00.000Z","USD":0.3,"DIEM":8.75}],"byModel":[{"modelName":"GLM 5.1","unitType":"tokens","modelType":"LLM","totalUsd":0.4,"totalDiem":12.5,"totalUnits":50000,"breakdown":[{"type":"Output","usd":0.3,"diem":10,"units":35000},{"type":"Input","usd":0.1,"diem":2.5,"units":15000}]}],"byModelDaily":[{"date":1705276800000,"GLM 5.1":5.5,"Kimi K2.6":3.2}],"topModels":["GLM 5.1","Kimi K2.6"],"byKey":[{"apiKeyId":"key_abc123","description":"Production Key","totalUsd":0.8,"totalDiem":15,"totalUnits":75000},{"apiKeyId":null,"description":"Web App","totalUsd":0,"totalDiem":4,"totalUnits":25000}],"byKeyDaily":[{"date":1705276800000,"Production Key":8.5,"Web App":2}],"topKeyNames":["Production Key","Web App"]}}},"exampleType":"generated"}},"exampleType":"generated"},"1a6063a4-1135-49bc-8826-3826b8ac3fc8":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","properties":{},"description":"Details about the incorrect input","example":{"_errors":[],"field":{"_errors":["Field is required"]}},"uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{"_errors":[],"field":{"_errors":["Field is required"]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"425dfa5f-8ba5-422b-a47c-211d02b1c4ae":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8635f966-1132-4f65-be43-2c2585d5ec30":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["This API key is restricted to configured IP addresses, and this request's source IP is not allowed"],"description":"A description of the error","example":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed"}}},"exampleType":"generated"}},"description":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","exampleType":"generated"},"99df9149-3373-4fac-a557-6502dd40942e":{"description":"Inference processing failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"59f87729-5f45-40fa-ac2a-b71f0687af14":{"description":"Query timed out - try reducing the lookback period","content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message indicating query timeout","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5ae61ed6-c925-4e36-a3b5-59b7cd2707f3":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d":{"url":"https://api.venice.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"swagger.yaml"},"subdomain":"veniceai","siteName":"Venice API Docs","title":"Analyses d'utilisation de facturation | Venice API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"ar":{"href":"/ar/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"it":{"href":"/it/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"de":{"href":"/de/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"es":{"href":"/es/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"fr":{"href":"/fr/api-reference/endpoint/billing/usage-analytics","matchLevel":0},"zh":{"href":"/zh/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"ko":{"href":"/ko/api-reference/endpoint/billing/usage-analytics","matchLevel":1}}},"lastModified":"2026-10-20T21:53:06.535Z","originalFileLocation":"fr/api-reference/endpoint/billing/usage-analytics.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Beta: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice. Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Analyses d\u0026#x27;utilisation de facturation | Venice API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Obtenez des analyses d\u0026#x27;utilisation agrégées avec des ventilations par date, modèle et clé API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Facturation\u0026amp;title=Analyses+d%27utilisation+de+facturation+%28Beta%29\u0026amp;description=**Beta**%3A+This+endpoint+is+currently+in+beta+and+may+be+unstable.+Request%2Fresponse+schemas+and+behavior+may+change+without+notice.%0A%0AGet+aggregated+usage+analyti\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=62b98d61d598f13fcadaa8d7620ce838b4cd506cbeebc576d2b6159c6fe99d2c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Analyses d\u0026#x27;utilisation de facturation | Venice API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Obtenez des analyses d\u0026#x27;utilisation agrégées avec des ventilations par date, modèle et clé API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Facturation\u0026amp;title=Analyses+d%27utilisation+de+facturation+%28Beta%29\u0026amp;description=**Beta**%3A+This+endpoint+is+currently+in+beta+and+may+be+unstable.+Request%2Fresponse+schemas+and+behavior+may+change+without+notice.%0A%0AGet+aggregated+usage+analyti\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=62b98d61d598f13fcadaa8d7620ce838b4cd506cbeebc576d2b6159c6fe99d2c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#125DA3\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/logo/light.svg\">\u003cmeta data-mint-head name=\"article:publisher\" content=\"Venice AI\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fr/api-reference/endpoint/billing/usage-analytics.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.venice.ai/it/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.venice.ai/zh/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-analytics\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.venice.ai/#organization\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.venice.ai#website\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics#webpage\",\"url\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\",\"name\":\"Analyses d'utilisation de facturation (Beta)\",\"description\":\"Beta: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice. Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.\",\"dateModified\":\"2026-10-20T21:53:06.535Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/fr/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Facturation\",\"item\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Analyses d'utilisation de facturation (Beta)\",\"item\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics#apireference\",\"headline\":\"Analyses d'utilisation de facturation (Beta)\",\"name\":\"Analyses d'utilisation de facturation (Beta)\",\"description\":\"Beta: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice. Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.\",\"url\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics#webpage\"},\"dateModified\":\"2026-10-20T21:53:06.535Z\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Venice API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Venice API Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/endpoint/billing/usage-analytics"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/endpoint/billing/usage-analytics"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/endpoint/billing/usage-analytics"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/endpoint/billing/usage-analytics"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/endpoint/billing/usage-analytics"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoint/billing/usage-analytics"}]},{"language":"fr","tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/fr/overview/about-venice"}]},{"tab":"Modèles","icon":"box","pages":[{"title":"Modèles","href":"/fr/models/overview"}]},{"tab":"Apprendre","icon":"layout-grid","pages":[{"title":"Apprendre","href":"/fr/learn"}]},{"tab":"Référence de l'API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introduction","href":"/fr/api-reference/api-spec"},{"title":"Limites de débit","href":"/fr/api-reference/rate-limiting"},{"title":"Codes d'erreur","href":"/fr/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/fr/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/fr/api-reference/endpoint/responses/create"},{"title":"Suffixe de fonctionnalité de modèle","href":"/fr/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Créer des décisions","openapi":"POST /decisions","href":"/fr/api-reference/endpoint/decisions/create"},{"title":"Compatibilité System One","openapi":"POST /systemone","href":"/fr/api-reference/endpoint/decisions/systemone"}]},{"group":"Images","expanded":false,"pages":[{"title":"Générer des images","openapi":"POST /image/generate","href":"/fr/api-reference/endpoint/image/generate"},{"title":"Agrandir et améliorer","openapi":"POST /image/upscale","href":"/fr/api-reference/endpoint/image/upscale"},{"title":"Éditer (aussi appelé Inpaint)","openapi":"POST /image/edit","href":"/fr/api-reference/endpoint/image/edit"},{"title":"Édition multi-images","openapi":"POST /image/multi-edit","href":"/fr/api-reference/endpoint/image/multi-edit"},{"title":"Suppression d'arrière-plan","openapi":"POST /image/background-remove","href":"/fr/api-reference/endpoint/image/background-remove"},{"title":"Styles d'image","openapi":"GET /image/styles","href":"/fr/api-reference/endpoint/image/styles"},{"title":"Générer des images (API compatible OpenAI)","openapi":"POST /images/generations","href":"/fr/api-reference/endpoint/image/generations"}]},{"group":"Audio","expanded":false,"pages":[{"title":"API Speech (Beta)","openapi":"POST /audio/speech","href":"/fr/api-reference/endpoint/audio/speech"},{"title":"Cloner une voix","openapi":"POST /audio/voices","href":"/fr/api-reference/endpoint/audio/voices"},{"title":"API Transcriptions (Beta)","openapi":"POST /audio/transcriptions","href":"/fr/api-reference/endpoint/audio/transcriptions"},{"title":"Mettre en file d'attente une génération audio","openapi":"POST /audio/queue","href":"/fr/api-reference/endpoint/audio/queue"},{"title":"Récupérer l'audio","openapi":"POST /audio/retrieve","href":"/fr/api-reference/endpoint/audio/retrieve"},{"title":"Devis pour la génération audio","openapi":"POST /audio/quote","href":"/fr/api-reference/endpoint/audio/quote"},{"title":"Compléter l'audio","openapi":"POST /audio/complete","href":"/fr/api-reference/endpoint/audio/complete"},{"title":"Mettre en file d'attente le changeur de voix","openapi":"POST /audio/voice-changer/queue","href":"/fr/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Récupérer le changeur de voix","openapi":"POST /audio/voice-changer/retrieve","href":"/fr/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Devis pour le changeur de voix","openapi":"POST /audio/voice-changer/quote","href":"/fr/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Compléter le changeur de voix","openapi":"POST /audio/voice-changer/complete","href":"/fr/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Vidéo","expanded":false,"pages":[{"title":"Mettre en file d'attente une génération vidéo","openapi":"POST /video/queue","href":"/fr/api-reference/endpoint/video/queue"},{"title":"Récupérer la vidéo","openapi":"POST /video/retrieve","href":"/fr/api-reference/endpoint/video/retrieve"},{"title":"Devis pour la génération vidéo","openapi":"POST /video/quote","href":"/fr/api-reference/endpoint/video/quote"},{"title":"Compléter la vidéo","openapi":"POST /video/complete","href":"/fr/api-reference/endpoint/video/complete"}]},{"group":"Outils","expanded":false,"pages":[{"title":"Analyseur de texte","openapi":"POST /augment/text-parser","href":"/fr/api-reference/endpoint/augment/text-parser"},{"title":"Web Scraping","openapi":"POST /augment/scrape","href":"/fr/api-reference/endpoint/augment/scrape"},{"title":"Recherche web","openapi":"POST /augment/search","href":"/fr/api-reference/endpoint/augment/search"},{"title":"Réseaux crypto","openapi":"GET /crypto/rpc/networks","href":"/fr/api-reference/endpoint/crypto/networks"},{"title":"RPC crypto","openapi":"POST /crypto/rpc/{network}","href":"/fr/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Générer des embeddings","openapi":"POST /embeddings","href":"/fr/api-reference/endpoint/embeddings/generate"}]},{"group":"Modèles","expanded":false,"pages":[{"title":"Lister les modèles","openapi":"GET /models","href":"/fr/api-reference/endpoint/models/list"},{"title":"Mappage de compatibilité","openapi":"GET /models/compatibility_mapping","href":"/fr/api-reference/endpoint/models/compatibility_mapping"},{"title":"Caractéristiques","openapi":"GET /models/traits","href":"/fr/api-reference/endpoint/models/traits"}]},{"group":"Clés d'API","expanded":false,"pages":[{"title":"Lister les clés API","openapi":"GET /api_keys","href":"/fr/api-reference/endpoint/api_keys/list"},{"title":"Obtenir les détails d'une clé API","openapi":"GET /api_keys/{id}","href":"/fr/api-reference/endpoint/api_keys/get"},{"title":"Créer une clé API","openapi":"POST /api_keys","href":"/fr/api-reference/endpoint/api_keys/create"},{"title":"Mettre à jour une clé API","openapi":"PATCH /api_keys","href":"/fr/api-reference/endpoint/api_keys/update"},{"title":"Supprimer une clé API","openapi":"DELETE /api_keys","href":"/fr/api-reference/endpoint/api_keys/delete"},{"title":"Générer une clé API avec un portefeuille Web3","openapi":"GET /api_keys/generate_web3_key","href":"/fr/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Générer une clé API avec un portefeuille Web3","openapi":"POST /api_keys/generate_web3_key","href":"/fr/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Limites des clés d'API","expanded":false,"pages":[{"title":"Limites de débit et soldes","openapi":"GET /api_keys/rate_limits","href":"/fr/api-reference/endpoint/api_keys/rate_limits"},{"title":"Journaux de limite de débit","openapi":"GET /api_keys/rate_limits/log","href":"/fr/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personnages","expanded":false,"pages":[{"title":"Obtenir un personnage","openapi":"GET /characters/{slug}","href":"/fr/api-reference/endpoint/characters/get"},{"title":"Lister les personnages","openapi":"GET /characters","href":"/fr/api-reference/endpoint/characters/list"},{"title":"Lister les avis sur un personnage","openapi":"GET /characters/{slug}/reviews","href":"/fr/api-reference/endpoint/characters/reviews"}]},{"group":"Facturation","expanded":false,"pages":[{"title":"Solde de facturation","openapi":"GET /billing/balance","href":"/fr/api-reference/endpoint/billing/balance"},{"title":"Utilisation de la facturation (supprimé)","openapi":"GET /billing/usage","description":"SUNSET as of 2026-09-16: this endpoint no longer returns usage data and answers every request with a 410. Use [GET /api/v1/billing/usage-history](https://docs.venice.ai/api-reference/endpoint/billing/usage-history) instead, which returns the same ledger entries with cursor pagination: replace `page` and `limit` with `pageSize` plus the `nextCursor` from each response, and `startDate` and `endDate` with `startTimestamp` and `endTimestamp`.","href":"/fr/api-reference/endpoint/billing/usage"},{"title":"Analyses d'utilisation de facturation (Beta)","openapi":"GET /billing/usage-analytics","href":"/fr/api-reference/endpoint/billing/usage-analytics"},{"title":"Historique d'utilisation de la facturation","openapi":"GET /billing/usage-history","description":"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.","href":"/fr/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Solde X402","openapi":"GET /x402/balance/{walletAddress}","href":"/fr/api-reference/endpoint/x402/balance"},{"title":"Recharge X402","openapi":"POST /x402/top-up","href":"/fr/api-reference/endpoint/x402/top-up"},{"title":"Transactions X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/fr/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Journal des modifications","icon":"history","href":"https://venice.ai/changelog"},{"tab":"Statut","icon":"activity","href":"https://veniceai-status.com"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/endpoint/billing/usage-analytics"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/endpoint/billing/usage-analytics"}]}]},"basePath":"","title":"Analyses d'utilisation de facturation | Venice API Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}