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>"
}
Este é um endpoint beta e pode estar instável ou mudar sem aviso prévio.
Obtenha análises agregadas de uso para o usuário autenticado, com divisões por data, modelo e chave de API. Este endpoint fornece visualizações resumidas dos seus dados de uso da API para construir dashboards e monitorar o consumo. Os dados são armazenados em cache por 10 minutos.
Você pode especificar o período para as análises usando:
lookback: Um período relativo como “7d” (7 dias), “30d” (30 dias), até “90d” (90 dias)
startDate e endDate: Um intervalo de datas personalizado no formato YYYY-MM-DD. Envie ambos para usar um intervalo personalizado.
Se nenhum parâmetro for especificado, o período padrão de lookback é de 7 dias.
Se você enviar apenas um entre startDate ou endDate, a requisição não falha: ela retorna 200 usando o lookback padrão de 7 dias e ignora a data, sem nenhum aviso. Sempre envie os dois juntos.Um lookback maior que 90 dias é limitado a 90d. Um intervalo startDate/endDate maior que 90 dias retorna 400.
Dados diários de gráfico para os 8 principais modelos. Cada entrada contém uma “date” (timestamp) mais nomes de modelos como chaves com valores de uso em DIEM.
Dados diários de gráfico para as 8 principais chaves de API. Cada entrada contém uma “date” (timestamp) mais descrições de chaves como chaves com valores de uso em DIEM.
# Obter análises de uso dos últimos 7 dias (padrão)curl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics" \ -H "Authorization: Bearer YOUR_API_KEY"# Obter análises de uso dos últimos 30 diascurl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics?lookback=30d" \ -H "Authorization: Bearer YOUR_API_KEY"# Obter análises de uso para um intervalo de datas específicocurl -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":"#125DA3","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"}},"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":"6aeb5f1fb21018c2553e9b10","collectionId":"db812bb8-6444-4a3d-ab80-1fc926c74977","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb5f1fb21018c2553e9b10"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb5f1fb21018c2553e9b10","clientVersion":"0.0.4054","searchFilterCounts":[{"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":"Models","count":11},{"language":"en","tag":"Text \u0026 Chat","count":11},{"language":"ar","tag":"النماذج","count":11},{"language":"ar","tag":"النص والدردشة","count":11},{"language":"de","tag":"Modelle","count":11},{"language":"de","tag":"Text \u0026 Chat","count":11},{"language":"es","tag":"Modelos","count":11},{"language":"es","tag":"Texto y chat","count":11},{"language":"fr","tag":"Modèles","count":11},{"language":"fr","tag":"Texte et chat","count":11},{"language":"it","tag":"Modelli","count":11},{"language":"it","tag":"Testo e chat","count":11},{"language":"ko","tag":"모델","count":11},{"language":"ko","tag":"텍스트 및 채팅","count":11},{"language":"pt-BR","tag":"Modelos","count":11},{"language":"pt-BR","tag":"Texto e chat","count":11},{"language":"zh","tag":"模型","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/veniceai/7e50b8754e176672/style.css"}],"page":{"pagePath":"pt-BR/api-reference/endpoint/billing/usage-analytics","slug":"/pt-BR/api-reference/endpoint/billing/usage-analytics","pageMetadata":{"title":"Análise de uso de cobrança (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Análise de uso de cobrança | Documentação da API Venice","og:description":"Obtenha análises agregadas de uso com divisões por data, modelo e chave de 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":"/pt-BR/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:`Este é um endpoint beta e pode estar instável ou mudar sem aviso prévio.`})}),`\n`,_jsx(_components.p,{children:`Obtenha análises agregadas de uso para o usuário autenticado, com divisões por data, modelo e chave de API. Este endpoint fornece visualizações resumidas dos seus dados de uso da API para construir dashboards e monitorar o consumo. Os dados são armazenados em cache por 10 minutos.`}),`\n`,_jsx(Heading,{level:`2`,id:`parâmetros-de-consulta`,children:`Parâmetros de consulta`}),`\n`,_jsx(_components.p,{children:`Você pode especificar o período para as análises usando:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`lookback`}),`: Um período relativo como “7d” (7 dias), “30d” (30 dias), até “90d” (90 dias)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`startDate`}),` e `,_jsx(_components.strong,{children:`endDate`}),`: Um intervalo de datas personalizado no formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. Envie ambos para usar um intervalo personalizado.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Se nenhum parâmetro for especificado, o período padrão de lookback é de 7 dias.`}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Se você enviar apenas um entre `,_jsx(_components.code,{children:`startDate`}),` ou `,_jsx(_components.code,{children:`endDate`}),`, a requisição não falha: ela retorna `,_jsx(_components.code,{children:`200`}),` usando o lookback padrão de 7 dias e ignora a data, sem nenhum aviso. Sempre envie os dois juntos.`]}),_jsxs(_components.p,{children:[`Um `,_jsx(_components.code,{children:`lookback`}),` maior que 90 dias é limitado a `,_jsx(_components.code,{children:`90d`}),`. Um intervalo `,_jsx(_components.code,{children:`startDate`}),`/`,_jsx(_components.code,{children:`endDate`}),` maior que 90 dias retorna `,_jsx(_components.code,{children:`400`}),`.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-de-resposta`,children:`Campos de resposta`}),`\n`,_jsx(Heading,{level:`3`,id:`lookback`,children:`lookback`}),`\n`,_jsx(_components.p,{children:`O período de lookback usado na consulta. No formato “Nd” (por exemplo, “7d”) ou no formato “startDate:endDate”.`}),`\n`,_jsx(Heading,{level:`3`,id:`bydate`,children:`byDate`}),`\n`,_jsx(_components.p,{children:`Totais diários de uso para o período solicitado.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`date`}),`: A data no formato `,_jsx(_components.code,{children:`YYYY-MM-DD`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`USD`}),`: Uso total em USD para aquele dia`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`DIEM`}),`: Uso total em DIEM para aquele dia`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodel`,children:`byModel`}),`\n`,_jsx(_components.p,{children:`Detalhamento de uso por modelo, ordenado por gasto total (do maior para o menor).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelName`}),`: Nome de exibição do modelo (por exemplo, “GLM 5”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`unitType`}),`: Tipo de unidades consumidas (tokens, imagens, caracteres, minutos, segundos)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelType`}),`: Tipo de modelo (LLM, IMAGE, TTS, ASR, VIDEO) ou nulo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: Total em USD gasto neste modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: Total em DIEM gasto neste modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),`: Total de unidades consumidas para este modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`breakdown`}),`: Array de detalhamentos de uso por tipo (presente apenas se houver múltiplos tipos). Cada entrada contém:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`type`}),`: Tipo de token (por exemplo, “Input”, “Output”, “Cache Read”, “Cache Write”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`usd`}),`: Valor em USD para este detalhamento`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`diem`}),`: Valor em DIEM para este detalhamento`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`units`}),`: Número de unidades para este detalhamento`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodeldaily`,children:`byModelDaily`}),`\n`,_jsx(_components.p,{children:`Dados diários de gráfico para os 8 principais modelos. Cada entrada contém uma “date” (timestamp) mais nomes de modelos como chaves com valores de uso em DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topmodels`,children:`topModels`}),`\n`,_jsx(_components.p,{children:`Array dos 8 principais nomes de modelos por uso, para legendas de gráficos.`}),`\n`,_jsx(Heading,{level:`3`,id:`bykey`,children:`byKey`}),`\n`,_jsx(_components.p,{children:`Detalhamento de uso por chave de API, ordenado por gasto total (do maior para o menor).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`apiKeyId`}),`: O ID da chave de API ou nulo se o uso foi pelo aplicativo web`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`description`}),`: Descrição da chave de API ou “Web App”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: Total em USD gasto por meio desta chave`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: Total em DIEM gasto por meio desta chave`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),`: Total de unidades consumidas por meio desta chave`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bykeydaily`,children:`byKeyDaily`}),`\n`,_jsx(_components.p,{children:`Dados diários de gráfico para as 8 principais chaves de API. Cada entrada contém uma “date” (timestamp) mais descrições de chaves como chaves com valores de uso em DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topkeynames`,children:`topKeyNames`}),`\n`,_jsx(_components.p,{children:`Array das 8 principais descrições de chaves de API por uso, para legendas de gráficos.`}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-uso`,children:`Exemplo de uso`}),`\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:`# Obter análises de uso dos últimos 7 dias (padrão)`})}),`\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:`# Obter análises de uso dos últimos 30 dias`})}),`\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:`# Obter análises de uso para um intervalo de datas específico`})}),`\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":"Análise de uso de cobrança (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Análise de uso de cobrança | Documentação da API Venice","og:description":"Obtenha análises agregadas de uso com divisões por data, modelo e chave de 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":"/pt-BR/api-reference/endpoint/billing/usage-analytics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parâmetros de consulta","slug":"parâmetros-de-consulta","depth":2,"children":[]},{"title":"Campos de resposta","slug":"campos-de-resposta","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":"Exemplo de uso","slug":"exemplo-de-uso","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":["342c2186-5e9a-4c7e-ba51-4371fe7688e5","a18112ad-4d8e-4629-9b2a-5302c0c0bd9c","dd0fe9d0-ba6b-428d-a6bd-53cabb8ecc2a"],"responses":{"200":"c64a5fba-1202-4f41-9fec-23f683e74ff0","400":"ddfaa97d-5fb6-412e-9ebd-d02aaa6438c3","401":"0ec116da-3e0d-45a3-8223-5d6da1cf30a7","403":"b92359f2-cb50-4a01-9298-406b242cd2ba","500":"4cf57ad2-ca22-424c-9c80-7b0f833e4f74","504":"5c7c2cc1-8c80-4b5a-9f1e-086d2fbe6b7c"},"method":"get","type":"path","servers":["5f1831bd-248c-480f-8517-5351929f450f"],"security":["c7c8f1c4-f842-466d-85a4-3d3e03a296d5"],"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":{"342c2186-5e9a-4c7e-ba51-4371fe7688e5":{"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"},"a18112ad-4d8e-4629-9b2a-5302c0c0bd9c":{"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"},"dd0fe9d0-ba6b-428d-a6bd-53cabb8ecc2a":{"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":{"c64a5fba-1202-4f41-9fec-23f683e74ff0":{"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"},"ddfaa97d-5fb6-412e-9ebd-d02aaa6438c3":{"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"},"0ec116da-3e0d-45a3-8223-5d6da1cf30a7":{"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"},"b92359f2-cb50-4a01-9298-406b242cd2ba":{"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"},"4cf57ad2-ca22-424c-9c80-7b0f833e4f74":{"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"},"5c7c2cc1-8c80-4b5a-9f1e-086d2fbe6b7c":{"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":{"c7c8f1c4-f842-466d-85a4-3d3e03a296d5":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"5f1831bd-248c-480f-8517-5351929f450f":{"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":"Análise de uso de cobrança | Documentação da API Venice","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":0},"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":1},"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:05.830Z","originalFileLocation":"pt-BR/api-reference/endpoint/billing/usage-analytics.mdx","locale":"pt-BR"},"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=\"system\"}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=\"Análise de uso de cobrança | Documentação da API Venice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Obtenha análises agregadas de uso com divisões por data, modelo e chave de 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/pt-BR/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=Faturamento\u0026amp;title=An%C3%A1lise+de+uso+de+cobran%C3%A7a+%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=508d743c1f2720564c9062e7\u0026amp;signature=52da302977c9a7baa8f3a317c2120192a08c20c22d2f3aeeb7eae9a92a209506\">\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=\"Análise de uso de cobrança | Documentação da API Venice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Obtenha análises agregadas de uso com divisões por data, modelo e chave de API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Faturamento\u0026amp;title=An%C3%A1lise+de+uso+de+cobran%C3%A7a+%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=508d743c1f2720564c9062e7\u0026amp;signature=52da302977c9a7baa8f3a317c2120192a08c20c22d2f3aeeb7eae9a92a209506\">\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/pt-BR/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=\"/pt-BR/api-reference/endpoint/billing/usage-analytics.md\">\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=\"en\" href=\"https://docs.venice.ai/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=\"fr\" href=\"https://docs.venice.ai/fr/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/pt-BR/api-reference/endpoint/billing/usage-analytics#webpage\",\"url\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics\",\"name\":\"Análise de uso de cobrança (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:05.830Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Faturamento\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Análise de uso de cobrança (Beta)\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics#apireference\",\"headline\":\"Análise de uso de cobrança (Beta)\",\"name\":\"Análise de uso de cobrança (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/pt-BR/api-reference/endpoint/billing/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics#webpage\"},\"dateModified\":\"2026-10-20T21:53:05.830Z\",\"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","tabs":[{"tab":"Documentação","icon":"book","pages":[{"title":"Documentação","href":"/pt-BR/overview/about-venice"}]},{"tab":"Modelos","icon":"box","pages":[{"title":"Modelos","href":"/pt-BR/models/overview"}]},{"tab":"Aprender","icon":"layout-grid","pages":[{"title":"Aprender","href":"/pt-BR/learn"}]},{"tab":"Referência da API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introdução","href":"/pt-BR/api-reference/api-spec"},{"title":"Limites de taxa","href":"/pt-BR/api-reference/rate-limiting"},{"title":"Códigos de erro","href":"/pt-BR/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/pt-BR/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/pt-BR/api-reference/endpoint/responses/create"},{"title":"Sufixo de recursos do modelo","href":"/pt-BR/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Criar decisões","openapi":"POST /decisions","href":"/pt-BR/api-reference/endpoint/decisions/create"},{"title":"Compatibilidade com System One","openapi":"POST /systemone","href":"/pt-BR/api-reference/endpoint/decisions/systemone"}]},{"group":"Imagens","expanded":false,"pages":[{"title":"Gerar imagens","openapi":"POST /image/generate","href":"/pt-BR/api-reference/endpoint/image/generate"},{"title":"Upscale e enhance","openapi":"POST /image/upscale","href":"/pt-BR/api-reference/endpoint/image/upscale"},{"title":"Editar (também conhecido como inpaint)","openapi":"POST /image/edit","href":"/pt-BR/api-reference/endpoint/image/edit"},{"title":"Edição múltipla de imagem","openapi":"POST /image/multi-edit","href":"/pt-BR/api-reference/endpoint/image/multi-edit"},{"title":"Remover plano de fundo","openapi":"POST /image/background-remove","href":"/pt-BR/api-reference/endpoint/image/background-remove"},{"title":"Estilos de imagem","openapi":"GET /image/styles","href":"/pt-BR/api-reference/endpoint/image/styles"},{"title":"Gerar imagens (API compatível com OpenAI)","openapi":"POST /images/generations","href":"/pt-BR/api-reference/endpoint/image/generations"}]},{"group":"Áudio","expanded":false,"pages":[{"title":"API de fala (Beta)","openapi":"POST /audio/speech","href":"/pt-BR/api-reference/endpoint/audio/speech"},{"title":"Clonar voz","openapi":"POST /audio/voices","href":"/pt-BR/api-reference/endpoint/audio/voices"},{"title":"API de transcrições (Beta)","openapi":"POST /audio/transcriptions","href":"/pt-BR/api-reference/endpoint/audio/transcriptions"},{"title":"Enfileirar geração de áudio","openapi":"POST /audio/queue","href":"/pt-BR/api-reference/endpoint/audio/queue"},{"title":"Recuperar áudio","openapi":"POST /audio/retrieve","href":"/pt-BR/api-reference/endpoint/audio/retrieve"},{"title":"Cotação de geração de áudio","openapi":"POST /audio/quote","href":"/pt-BR/api-reference/endpoint/audio/quote"},{"title":"Concluir áudio","openapi":"POST /audio/complete","href":"/pt-BR/api-reference/endpoint/audio/complete"},{"title":"Enfileirar trocador de voz","openapi":"POST /audio/voice-changer/queue","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Recuperar trocador de voz","openapi":"POST /audio/voice-changer/retrieve","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Cotação do trocador de voz","openapi":"POST /audio/voice-changer/quote","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Concluir trocador de voz","openapi":"POST /audio/voice-changer/complete","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Vídeo","expanded":false,"pages":[{"title":"Enfileirar Geração de Vídeo","openapi":"POST /video/queue","href":"/pt-BR/api-reference/endpoint/video/queue"},{"title":"Recuperar vídeo","openapi":"POST /video/retrieve","href":"/pt-BR/api-reference/endpoint/video/retrieve"},{"title":"Cotação de geração de vídeo","openapi":"POST /video/quote","href":"/pt-BR/api-reference/endpoint/video/quote"},{"title":"Concluir vídeo","openapi":"POST /video/complete","href":"/pt-BR/api-reference/endpoint/video/complete"}]},{"group":"Ferramentas","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/pt-BR/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/pt-BR/api-reference/endpoint/augment/scrape"},{"title":"Web Search","openapi":"POST /augment/search","href":"/pt-BR/api-reference/endpoint/augment/search"},{"title":"Redes cripto","openapi":"GET /crypto/rpc/networks","href":"/pt-BR/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/pt-BR/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Gerar embeddings","openapi":"POST /embeddings","href":"/pt-BR/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelos","expanded":false,"pages":[{"title":"Listar modelos","openapi":"GET /models","href":"/pt-BR/api-reference/endpoint/models/list"},{"title":"Mapeamento de compatibilidade","openapi":"GET /models/compatibility_mapping","href":"/pt-BR/api-reference/endpoint/models/compatibility_mapping"},{"title":"Atributos","openapi":"GET /models/traits","href":"/pt-BR/api-reference/endpoint/models/traits"}]},{"group":"Chaves de API","expanded":false,"pages":[{"title":"Listar chaves de API","openapi":"GET /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/list"},{"title":"Obter detalhes da chave de API","openapi":"GET /api_keys/{id}","href":"/pt-BR/api-reference/endpoint/api_keys/get"},{"title":"Criar chave de API","openapi":"POST /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/create"},{"title":"Atualizar chave de API","openapi":"PATCH /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/update"},{"title":"Excluir chave de API","openapi":"DELETE /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/delete"},{"title":"Gerar chave de API com carteira Web3","openapi":"GET /api_keys/generate_web3_key","href":"/pt-BR/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Gerar chave de API com carteira Web3","openapi":"POST /api_keys/generate_web3_key","href":"/pt-BR/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Limites das chaves de API","expanded":false,"pages":[{"title":"Limites de taxa e saldos","openapi":"GET /api_keys/rate_limits","href":"/pt-BR/api-reference/endpoint/api_keys/rate_limits"},{"title":"Logs de limite de taxa","openapi":"GET /api_keys/rate_limits/log","href":"/pt-BR/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personagens","expanded":false,"pages":[{"title":"Obter personagem","openapi":"GET /characters/{slug}","href":"/pt-BR/api-reference/endpoint/characters/get"},{"title":"Listar personagens","openapi":"GET /characters","href":"/pt-BR/api-reference/endpoint/characters/list"},{"title":"Listar avaliações de personagens","openapi":"GET /characters/{slug}/reviews","href":"/pt-BR/api-reference/endpoint/characters/reviews"}]},{"group":"Faturamento","expanded":false,"pages":[{"title":"Saldo de cobrança","openapi":"GET /billing/balance","href":"/pt-BR/api-reference/endpoint/billing/balance"},{"title":"Uso de faturamento (removido)","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":"/pt-BR/api-reference/endpoint/billing/usage"},{"title":"Análise de uso de cobrança (Beta)","openapi":"GET /billing/usage-analytics","href":"/pt-BR/api-reference/endpoint/billing/usage-analytics"},{"title":"Histórico de uso de faturamento","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":"/pt-BR/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Saldo X402","openapi":"GET /x402/balance/{walletAddress}","href":"/pt-BR/api-reference/endpoint/x402/balance"},{"title":"Recarga X402","openapi":"POST /x402/top-up","href":"/pt-BR/api-reference/endpoint/x402/top-up"},{"title":"Transações X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/pt-BR/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Alterações","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"Status","icon":"activity","href":"https://veniceai-status.com"}]},{"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","pages":[{"title":"fr","href":"/fr/api-reference/endpoint/billing/usage-analytics"}]},{"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":"Análise de uso de cobrança | Documentação da API Venice","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-Buji1S4J.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}