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 es un endpoint en beta y puede ser inestable o cambiar sin previo aviso.
Obtén analíticas de uso agregadas para el usuario autenticado, con desgloses por fecha, modelo y API key. Este endpoint proporciona vistas resumidas de los datos de uso de tu API para crear paneles y monitorizar el consumo. Los datos se almacenan en caché durante 10 minutos.
Puedes especificar el periodo de tiempo para las analíticas mediante:
lookback: un periodo relativo como “7d” (7 días), “30d” (30 días), hasta “90d” (90 días)
startDate y endDate: un rango de fechas personalizado en formato YYYY-MM-DD. Envía ambos para usar un rango personalizado.
Si no se especifica ningún parámetro, el periodo de lookback predeterminado es de 7 días.
Si envías solo uno de startDate o endDate, la solicitud no falla: devuelve 200 usando el lookback predeterminado de 7 días e ignora la fecha, sin ninguna advertencia. Envía siempre ambos juntos.Un lookback superior a 90 días se limita a 90d. Un rango startDate/endDate superior a 90 días devuelve 400.
Datos de gráfico diarios para los 8 modelos principales. Cada entrada contiene una “date” (timestamp) más los nombres de modelo como claves con valores de uso en DIEM.
Datos de gráfico diarios para las 8 API keys principales. Cada entrada contiene una “date” (timestamp) más las descripciones de las claves como claves con valores de uso en DIEM.
# Obtener analíticas de uso de los últimos 7 días (predeterminado)curl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics" \ -H "Authorization: Bearer YOUR_API_KEY"# Obtener analíticas de uso de los últimos 30 díascurl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics?lookback=30d" \ -H "Authorization: Bearer YOUR_API_KEY"# Obtener analíticas de uso para un rango de fechas 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":"es/api-reference/endpoint/billing/usage-analytics","slug":"/es/api-reference/endpoint/billing/usage-analytics","pageMetadata":{"title":"Analíticas de uso de facturación (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Billing Usage Analytics | Venice API Docs","og:description":"Obtén analíticas de uso agregadas con desgloses por fecha, modelo y API key.","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":"/es/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 es un endpoint en beta y puede ser inestable o cambiar sin previo aviso.`})}),`\n`,_jsx(_components.p,{children:`Obtén analíticas de uso agregadas para el usuario autenticado, con desgloses por fecha, modelo y API key. Este endpoint proporciona vistas resumidas de los datos de uso de tu API para crear paneles y monitorizar el consumo. Los datos se almacenan en caché durante 10 minutos.`}),`\n`,_jsx(Heading,{level:`2`,id:`parámetros-de-consulta`,children:`Parámetros de consulta`}),`\n`,_jsx(_components.p,{children:`Puedes especificar el periodo de tiempo para las analíticas mediante:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`lookback`}),`: un periodo relativo como “7d” (7 días), “30d” (30 días), hasta “90d” (90 días)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`startDate`}),` y `,_jsx(_components.strong,{children:`endDate`}),`: un rango de fechas personalizado en formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. Envía ambos para usar un rango personalizado.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Si no se especifica ningún parámetro, el periodo de lookback predeterminado es de 7 días.`}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Si envías solo uno de `,_jsx(_components.code,{children:`startDate`}),` o `,_jsx(_components.code,{children:`endDate`}),`, la solicitud no falla: devuelve `,_jsx(_components.code,{children:`200`}),` usando el lookback predeterminado de 7 días e ignora la fecha, sin ninguna advertencia. Envía siempre ambos juntos.`]}),_jsxs(_components.p,{children:[`Un `,_jsx(_components.code,{children:`lookback`}),` superior a 90 días se limita a `,_jsx(_components.code,{children:`90d`}),`. Un rango `,_jsx(_components.code,{children:`startDate`}),`/`,_jsx(_components.code,{children:`endDate`}),` superior a 90 días devuelve `,_jsx(_components.code,{children:`400`}),`.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-de-respuesta`,children:`Campos de respuesta`}),`\n`,_jsx(Heading,{level:`3`,id:`lookback`,children:`lookback`}),`\n`,_jsx(_components.p,{children:`El periodo de lookback utilizado para la consulta. Puede estar en formato “Nd” (p. ej., “7d”) o “startDate:endDate”.`}),`\n`,_jsx(Heading,{level:`3`,id:`bydate`,children:`byDate`}),`\n`,_jsx(_components.p,{children:`Totales de uso diarios para el periodo solicitado.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`date`}),`: la fecha en formato `,_jsx(_components.code,{children:`YYYY-MM-DD`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`USD`}),`: uso total en USD para ese día`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`DIEM`}),`: uso total en DIEM para ese día`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodel`,children:`byModel`}),`\n`,_jsx(_components.p,{children:`Desglose de uso por modelo, ordenado por gasto total (mayor primero).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelName`}),`: nombre del modelo para mostrar (p. ej., “GLM 5”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`unitType`}),`: tipo de unidades consumidas (tokens, images, chars, minutes, seconds)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelType`}),`: tipo de modelo (LLM, IMAGE, TTS, ASR, VIDEO), o null`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: total en USD gastado en este modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: total en DIEM gastado en este 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 desgloses de uso por tipo (solo presente si hay múltiples tipos). Cada entrada contiene:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`type`}),`: tipo de token (p. ej., “Input”, “Output”, “Cache Read”, “Cache Write”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`usd`}),`: importe en USD para este desglose`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`diem`}),`: importe en DIEM para este desglose`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`units`}),`: número de unidades para este desglose`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodeldaily`,children:`byModelDaily`}),`\n`,_jsx(_components.p,{children:`Datos de gráfico diarios para los 8 modelos principales. Cada entrada contiene una “date” (timestamp) más los nombres de modelo como claves con valores de uso en DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topmodels`,children:`topModels`}),`\n`,_jsx(_components.p,{children:`Array de los 8 nombres de modelos principales por uso, para leyendas de gráficos.`}),`\n`,_jsx(Heading,{level:`3`,id:`bykey`,children:`byKey`}),`\n`,_jsx(_components.p,{children:`Desglose de uso por API key, ordenado por gasto total (mayor primero).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`apiKeyId`}),`: el ID de la API key, o null si el uso provino de la aplicación web`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`description`}),`: descripción de la API key o “Web App”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: total en USD gastado mediante esta clave`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: total en DIEM gastado mediante esta clave`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),`: total de unidades consumidas mediante esta clave`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bykeydaily`,children:`byKeyDaily`}),`\n`,_jsx(_components.p,{children:`Datos de gráfico diarios para las 8 API keys principales. Cada entrada contiene una “date” (timestamp) más las descripciones de las claves como claves con valores de uso en DIEM.`}),`\n`,_jsx(Heading,{level:`3`,id:`topkeynames`,children:`topKeyNames`}),`\n`,_jsx(_components.p,{children:`Array de las 8 descripciones de API key principales por uso, para leyendas de gráficos.`}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplo-de-uso`,children:`Ejemplo 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:`# Obtener analíticas de uso de los últimos 7 días (predeterminado)`})}),`\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:`# Obtener analíticas de uso de los últimos 30 días`})}),`\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:`# Obtener analíticas de uso para un rango de fechas 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":"Analíticas de uso de facturación (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Billing Usage Analytics | Venice API Docs","og:description":"Obtén analíticas de uso agregadas con desgloses por fecha, modelo y API key.","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":"/es/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 respuesta","slug":"campos-de-respuesta","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":"Ejemplo de uso","slug":"ejemplo-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":"Billing Usage Analytics | 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":0},"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:06.749Z","originalFileLocation":"es/api-reference/endpoint/billing/usage-analytics.mdx","locale":"es"},"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=\"Billing Usage Analytics | Venice API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Obtén analíticas de uso agregadas con desgloses por fecha, modelo y API key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/es/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=Facturaci%C3%B3n\u0026amp;title=Anal%C3%ADticas+de+uso+de+facturaci%C3%B3n+%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=8e717e6814eb5305e9d156a7361c60e71ae4f699de4749921c410b7638638ac2\">\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=\"Billing Usage Analytics | Venice API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Obtén analíticas de uso agregadas con desgloses por fecha, modelo y API key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Facturaci%C3%B3n\u0026amp;title=Anal%C3%ADticas+de+uso+de+facturaci%C3%B3n+%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=8e717e6814eb5305e9d156a7361c60e71ae4f699de4749921c410b7638638ac2\">\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/es/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=\"/es/api-reference/endpoint/billing/usage-analytics.md\">\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=\"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=\"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/es/api-reference/endpoint/billing/usage-analytics#webpage\",\"url\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics\",\"name\":\"Analíticas de uso de facturación (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.749Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/es/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Facturación\",\"item\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Analíticas de uso de facturación (Beta)\",\"item\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics#apireference\",\"headline\":\"Analíticas de uso de facturación (Beta)\",\"name\":\"Analíticas de uso de facturación (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/es/api-reference/endpoint/billing/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics#webpage\"},\"dateModified\":\"2026-10-20T21:53:06.749Z\",\"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","tabs":[{"tab":"Documentación","icon":"book","pages":[{"title":"Documentación","href":"/es/overview/about-venice"}]},{"tab":"Modelos","icon":"box","pages":[{"title":"Modelos","href":"/es/models/overview"}]},{"tab":"Aprender","icon":"layout-grid","pages":[{"title":"Aprender","href":"/es/learn"}]},{"tab":"Referencia de la API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introducción","href":"/es/api-reference/api-spec"},{"title":"Límites de velocidad","href":"/es/api-reference/rate-limiting"},{"title":"Códigos de error","href":"/es/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/es/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/es/api-reference/endpoint/responses/create"},{"title":"Sufijo de características del modelo","href":"/es/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Crear decisiones","openapi":"POST /decisions","href":"/es/api-reference/endpoint/decisions/create"},{"title":"Compatibilidad con System One","openapi":"POST /systemone","href":"/es/api-reference/endpoint/decisions/systemone"}]},{"group":"Imágenes","expanded":false,"pages":[{"title":"Generar imágenes","openapi":"POST /image/generate","href":"/es/api-reference/endpoint/image/generate"},{"title":"Escalar y mejorar","openapi":"POST /image/upscale","href":"/es/api-reference/endpoint/image/upscale"},{"title":"Editar (Inpaint)","openapi":"POST /image/edit","href":"/es/api-reference/endpoint/image/edit"},{"title":"Edición múltiple de imágenes","openapi":"POST /image/multi-edit","href":"/es/api-reference/endpoint/image/multi-edit"},{"title":"Eliminar fondo","openapi":"POST /image/background-remove","href":"/es/api-reference/endpoint/image/background-remove"},{"title":"Estilos de imagen","openapi":"GET /image/styles","href":"/es/api-reference/endpoint/image/styles"},{"title":"Generar imágenes (API compatible con OpenAI)","openapi":"POST /images/generations","href":"/es/api-reference/endpoint/image/generations"}]},{"group":"Audio","expanded":false,"pages":[{"title":"API de voz (Beta)","openapi":"POST /audio/speech","href":"/es/api-reference/endpoint/audio/speech"},{"title":"Clonar voz","openapi":"POST /audio/voices","href":"/es/api-reference/endpoint/audio/voices"},{"title":"API de transcripciones (Beta)","openapi":"POST /audio/transcriptions","href":"/es/api-reference/endpoint/audio/transcriptions"},{"title":"Encolar generación de audio","openapi":"POST /audio/queue","href":"/es/api-reference/endpoint/audio/queue"},{"title":"Recuperar audio","openapi":"POST /audio/retrieve","href":"/es/api-reference/endpoint/audio/retrieve"},{"title":"Cotizar generación de audio","openapi":"POST /audio/quote","href":"/es/api-reference/endpoint/audio/quote"},{"title":"Completar audio","openapi":"POST /audio/complete","href":"/es/api-reference/endpoint/audio/complete"},{"title":"Encolar Voice Changer","openapi":"POST /audio/voice-changer/queue","href":"/es/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Recuperar Voice Changer","openapi":"POST /audio/voice-changer/retrieve","href":"/es/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Cotizar Voice Changer","openapi":"POST /audio/voice-changer/quote","href":"/es/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Completar Voice Changer","openapi":"POST /audio/voice-changer/complete","href":"/es/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Vídeo","expanded":false,"pages":[{"title":"Encolar generación de vídeo","openapi":"POST /video/queue","href":"/es/api-reference/endpoint/video/queue"},{"title":"Recuperar vídeo","openapi":"POST /video/retrieve","href":"/es/api-reference/endpoint/video/retrieve"},{"title":"Cotizar generación de vídeo","openapi":"POST /video/quote","href":"/es/api-reference/endpoint/video/quote"},{"title":"Completar vídeo","openapi":"POST /video/complete","href":"/es/api-reference/endpoint/video/complete"}]},{"group":"Herramientas","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/es/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/es/api-reference/endpoint/augment/scrape"},{"title":"Búsqueda web","openapi":"POST /augment/search","href":"/es/api-reference/endpoint/augment/search"},{"title":"Redes cripto","openapi":"GET /crypto/rpc/networks","href":"/es/api-reference/endpoint/crypto/networks"},{"title":"RPC cripto","openapi":"POST /crypto/rpc/{network}","href":"/es/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Generar embeddings","openapi":"POST /embeddings","href":"/es/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelos","expanded":false,"pages":[{"title":"Listar modelos","openapi":"GET /models","href":"/es/api-reference/endpoint/models/list"},{"title":"Mapa de compatibilidad","openapi":"GET /models/compatibility_mapping","href":"/es/api-reference/endpoint/models/compatibility_mapping"},{"title":"Características","openapi":"GET /models/traits","href":"/es/api-reference/endpoint/models/traits"}]},{"group":"Claves de API","expanded":false,"pages":[{"title":"Listar API Keys","openapi":"GET /api_keys","href":"/es/api-reference/endpoint/api_keys/list"},{"title":"Obtener detalles de la API Key","openapi":"GET /api_keys/{id}","href":"/es/api-reference/endpoint/api_keys/get"},{"title":"Crear API Key","openapi":"POST /api_keys","href":"/es/api-reference/endpoint/api_keys/create"},{"title":"Actualizar API Key","openapi":"PATCH /api_keys","href":"/es/api-reference/endpoint/api_keys/update"},{"title":"Eliminar API Key","openapi":"DELETE /api_keys","href":"/es/api-reference/endpoint/api_keys/delete"},{"title":"Generar API Key con monedero Web3","openapi":"GET /api_keys/generate_web3_key","href":"/es/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Generar API Key con monedero Web3","openapi":"POST /api_keys/generate_web3_key","href":"/es/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Límites de las claves de API","expanded":false,"pages":[{"title":"Límites de velocidad y saldos","openapi":"GET /api_keys/rate_limits","href":"/es/api-reference/endpoint/api_keys/rate_limits"},{"title":"Registros de límites de velocidad","openapi":"GET /api_keys/rate_limits/log","href":"/es/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personajes","expanded":false,"pages":[{"title":"Obtener personaje","openapi":"GET /characters/{slug}","href":"/es/api-reference/endpoint/characters/get"},{"title":"Listar personajes","openapi":"GET /characters","href":"/es/api-reference/endpoint/characters/list"},{"title":"Listar reseñas de personaje","openapi":"GET /characters/{slug}/reviews","href":"/es/api-reference/endpoint/characters/reviews"}]},{"group":"Facturación","expanded":false,"pages":[{"title":"Saldo de facturación","openapi":"GET /billing/balance","href":"/es/api-reference/endpoint/billing/balance"},{"title":"Uso de facturación (eliminado)","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":"/es/api-reference/endpoint/billing/usage"},{"title":"Analíticas de uso de facturación (Beta)","openapi":"GET /billing/usage-analytics","href":"/es/api-reference/endpoint/billing/usage-analytics"},{"title":"Historial de uso de facturación","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":"/es/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Saldo X402","openapi":"GET /x402/balance/{walletAddress}","href":"/es/api-reference/endpoint/x402/balance"},{"title":"Recarga X402","openapi":"POST /x402/top-up","href":"/es/api-reference/endpoint/x402/top-up"},{"title":"Transacciones X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/es/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Cambios","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"Estado","icon":"activity","href":"https://veniceai-status.com"}]},{"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":"Billing Usage Analytics | Venice API Docs","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"]}