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.
lookback: “7d”(7일), “30d”(30일)와 같은 상대 기간, 최대 “90d”(90일)까지
startDate 및 endDate: YYYY-MM-DD 형식의 사용자 지정 날짜 범위. 사용자 지정 범위를 사용하려면 둘 다 보내세요.
매개변수가 지정되지 않으면 기본 lookback 기간은 7일입니다.
startDate 또는 endDate 중 하나만 보내도 요청은 실패하지 않습니다. 경고 없이 해당 날짜를 무시하고 기본 7일 lookback을 사용하여 200을 반환합니다. 항상 두 값을 함께 보내세요.90일보다 긴 lookback은 90d로 제한됩니다. 90일보다 긴 startDate/endDate 범위는 400을 반환합니다.
# 지난 7일간의 사용량 분석 가져오기 (기본값)curl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics" \ -H "Authorization: Bearer YOUR_API_KEY"# 지난 30일간의 사용량 분석 가져오기curl -X GET "https://api.venice.ai/api/v1/billing/usage-analytics?lookback=30d" \ -H "Authorization: Bearer YOUR_API_KEY"# 특정 날짜 범위의 사용량 분석 가져오기curl -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":"ko/api-reference/endpoint/billing/usage-analytics","slug":"/ko/api-reference/endpoint/billing/usage-analytics","pageMetadata":{"title":"청구 사용량 분석 (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Billing Usage Analytics | Venice API Docs","og:description":"Get aggregated usage analytics with breakdowns by date, model, and 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":"/ko/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:`이것은 베타 엔드포인트이며 불안정하거나 사전 통보 없이 변경될 수 있습니다.`})}),`\n`,_jsx(_components.p,{children:`날짜, 모델 및 API 키별 분석이 포함된 인증된 사용자의 집계된 사용량 분석을 가져옵니다. 이 엔드포인트는 대시보드 구축 및 소비 모니터링을 위한 API 사용 데이터의 요약 보기를 제공합니다. 데이터는 10분 동안 캐시됩니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`쿼리-매개변수`,children:`쿼리 매개변수`}),`\n`,_jsx(_components.p,{children:`다음 중 하나를 사용하여 분석 기간을 지정할 수 있습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`lookback`}),`: “7d”(7일), “30d”(30일)와 같은 상대 기간, 최대 “90d”(90일)까지`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`startDate`}),` 및 `,_jsx(_components.strong,{children:`endDate`}),`: `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` 형식의 사용자 지정 날짜 범위. 사용자 지정 범위를 사용하려면 둘 다 보내세요.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`매개변수가 지정되지 않으면 기본 lookback 기간은 7일입니다.`}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`startDate`}),` 또는 `,_jsx(_components.code,{children:`endDate`}),` 중 하나만 보내도 요청은 실패하지 않습니다. 경고 없이 해당 날짜를 무시하고 기본 7일 lookback을 사용하여 `,_jsx(_components.code,{children:`200`}),`을 반환합니다. 항상 두 값을 함께 보내세요.`]}),_jsxs(_components.p,{children:[`90일보다 긴 `,_jsx(_components.code,{children:`lookback`}),`은 `,_jsx(_components.code,{children:`90d`}),`로 제한됩니다. 90일보다 긴 `,_jsx(_components.code,{children:`startDate`}),`/`,_jsx(_components.code,{children:`endDate`}),` 범위는 `,_jsx(_components.code,{children:`400`}),`을 반환합니다.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`응답-필드`,children:`응답 필드`}),`\n`,_jsx(Heading,{level:`3`,id:`lookback`,children:`lookback`}),`\n`,_jsx(_components.p,{children:`쿼리에 사용된 lookback 기간. “Nd” 형식(예: “7d”) 또는 “startDate:endDate” 형식입니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`bydate`,children:`byDate`}),`\n`,_jsx(_components.p,{children:`요청된 기간의 일일 사용량 합계.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`date`}),`: `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` 형식의 날짜`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`USD`}),`: 해당 일의 USD 총 사용량`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`DIEM`}),`: 해당 일의 DIEM 총 사용량`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodel`,children:`byModel`}),`\n`,_jsx(_components.p,{children:`모델별 사용량 분석, 총 지출별로 정렬됨(높은 순).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelName`}),`: 모델의 표시 이름(예: “GLM 5”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`unitType`}),`: 소비된 단위 유형(tokens, images, chars, minutes, seconds)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`modelType`}),`: 모델 유형(LLM, IMAGE, TTS, ASR, VIDEO) 또는 null`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: 이 모델에 지출된 총 USD`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: 이 모델에 지출된 총 DIEM`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),`: 이 모델에서 소비된 총 단위`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`breakdown`}),`: 유형별 사용량 분석 배열(여러 유형이 있는 경우에만 표시). 각 항목에는 다음이 포함됩니다:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`type`}),`: 토큰 유형(예: “Input”, “Output”, “Cache Read”, “Cache Write”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`usd`}),`: 이 분석의 USD 금액`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`diem`}),`: 이 분석의 DIEM 금액`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`units`}),`: 이 분석의 단위 수`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bymodeldaily`,children:`byModelDaily`}),`\n`,_jsx(_components.p,{children:`상위 8개 모델에 대한 일일 차트 데이터. 각 항목에는 “date”(타임스탬프)와 키로 모델 이름, 값으로 DIEM 사용량이 포함됩니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`topmodels`,children:`topModels`}),`\n`,_jsx(_components.p,{children:`사용량 기준 상위 8개 모델 이름 배열, 차트 범례용.`}),`\n`,_jsx(Heading,{level:`3`,id:`bykey`,children:`byKey`}),`\n`,_jsx(_components.p,{children:`API 키별 사용량 분석, 총 지출별로 정렬됨(높은 순).`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`apiKeyId`}),`: API 키 ID, 웹 앱에서 사용한 경우 null`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`description`}),`: API 키 설명 또는 “Web App”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: 이 키를 통해 지출된 총 USD`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalDiem`}),`: 이 키를 통해 지출된 총 DIEM`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUnits`}),`: 이 키를 통해 소비된 총 단위`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`bykeydaily`,children:`byKeyDaily`}),`\n`,_jsx(_components.p,{children:`상위 8개 API 키에 대한 일일 차트 데이터. 각 항목에는 “date”(타임스탬프)와 키로 키 설명, 값으로 DIEM 사용량이 포함됩니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`topkeynames`,children:`topKeyNames`}),`\n`,_jsx(_components.p,{children:`사용량 기준 상위 8개 API 키 설명 배열, 차트 범례용.`}),`\n`,_jsx(Heading,{level:`2`,id:`예제-사용법`,children:`예제 사용법`}),`\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:`# 지난 7일간의 사용량 분석 가져오기 (기본값)`})}),`\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:`# 지난 30일간의 사용량 분석 가져오기`})}),`\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:`# 특정 날짜 범위의 사용량 분석 가져오기`})}),`\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":"청구 사용량 분석 (Beta)","openapi":"GET /billing/usage-analytics","og:title":"Billing Usage Analytics | Venice API Docs","og:description":"Get aggregated usage analytics with breakdowns by date, model, and 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":"/ko/api-reference/endpoint/billing/usage-analytics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"쿼리 매개변수","slug":"쿼리-매개변수","depth":2,"children":[]},{"title":"응답 필드","slug":"응답-필드","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":"예제 사용법","slug":"예제-사용법","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":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":0}}},"lastModified":"2026-10-20T21:53:06.044Z","originalFileLocation":"ko/api-reference/endpoint/billing/usage-analytics.mdx","locale":"ko"},"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=\"Get aggregated usage analytics with breakdowns by date, model, and 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/ko/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=%EA%B2%B0%EC%A0%9C\u0026amp;title=%EC%B2%AD%EA%B5%AC+%EC%82%AC%EC%9A%A9%EB%9F%89+%EB%B6%84%EC%84%9D+%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=ae03f1a4b7af4547a84f4cd95351a6810a54c3e27d3792aba3141107b3b764bc\">\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=\"Get aggregated usage analytics with breakdowns by date, model, and API key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=%EA%B2%B0%EC%A0%9C\u0026amp;title=%EC%B2%AD%EA%B5%AC+%EC%82%AC%EC%9A%A9%EB%9F%89+%EB%B6%84%EC%84%9D+%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=ae03f1a4b7af4547a84f4cd95351a6810a54c3e27d3792aba3141107b3b764bc\">\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/ko/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=\"/ko/api-reference/endpoint/billing/usage-analytics.md\">\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=\"en\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.venice.ai/it/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"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=\"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/ko/api-reference/endpoint/billing/usage-analytics#webpage\",\"url\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics\",\"name\":\"청구 사용량 분석 (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.044Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/ko/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"결제\",\"item\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"청구 사용량 분석 (Beta)\",\"item\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics#apireference\",\"headline\":\"청구 사용량 분석 (Beta)\",\"name\":\"청구 사용량 분석 (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/ko/api-reference/endpoint/billing/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics#webpage\"},\"dateModified\":\"2026-10-20T21:53:06.044Z\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Venice API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Venice API Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/endpoint/billing/usage-analytics"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/endpoint/billing/usage-analytics"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/endpoint/billing/usage-analytics"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/endpoint/billing/usage-analytics"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/endpoint/billing/usage-analytics"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoint/billing/usage-analytics"}]},{"language":"fr","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","tabs":[{"tab":"문서","icon":"book","pages":[{"title":"문서","href":"/ko/overview/about-venice"}]},{"tab":"모델","icon":"box","pages":[{"title":"모델","href":"/ko/models/overview"}]},{"tab":"학습","icon":"layout-grid","pages":[{"title":"학습","href":"/ko/learn"}]},{"tab":"API 레퍼런스","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"소개","href":"/ko/api-reference/api-spec"},{"title":"속도 제한","href":"/ko/api-reference/rate-limiting"},{"title":"오류 코드","href":"/ko/api-reference/error-codes"},{"group":"채팅","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/ko/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/ko/api-reference/endpoint/responses/create"},{"title":"모델 기능 접미사","href":"/ko/api-reference/endpoint/chat/model_feature_suffix"},{"title":"결정 생성","openapi":"POST /decisions","href":"/ko/api-reference/endpoint/decisions/create"},{"title":"System One 호환성","openapi":"POST /systemone","href":"/ko/api-reference/endpoint/decisions/systemone"}]},{"group":"이미지","expanded":false,"pages":[{"title":"이미지 생성","openapi":"POST /image/generate","href":"/ko/api-reference/endpoint/image/generate"},{"title":"업스케일 및 향상","openapi":"POST /image/upscale","href":"/ko/api-reference/endpoint/image/upscale"},{"title":"편집 (인페인트)","openapi":"POST /image/edit","href":"/ko/api-reference/endpoint/image/edit"},{"title":"다중 이미지 편집","openapi":"POST /image/multi-edit","href":"/ko/api-reference/endpoint/image/multi-edit"},{"title":"배경 제거","openapi":"POST /image/background-remove","href":"/ko/api-reference/endpoint/image/background-remove"},{"title":"이미지 스타일","openapi":"GET /image/styles","href":"/ko/api-reference/endpoint/image/styles"},{"title":"이미지 생성 (OpenAI 호환 API)","openapi":"POST /images/generations","href":"/ko/api-reference/endpoint/image/generations"}]},{"group":"오디오","expanded":false,"pages":[{"title":"음성 API (Beta)","openapi":"POST /audio/speech","href":"/ko/api-reference/endpoint/audio/speech"},{"title":"음성 복제","openapi":"POST /audio/voices","href":"/ko/api-reference/endpoint/audio/voices"},{"title":"전사 API (Beta)","openapi":"POST /audio/transcriptions","href":"/ko/api-reference/endpoint/audio/transcriptions"},{"title":"오디오 생성 큐","openapi":"POST /audio/queue","href":"/ko/api-reference/endpoint/audio/queue"},{"title":"오디오 검색","openapi":"POST /audio/retrieve","href":"/ko/api-reference/endpoint/audio/retrieve"},{"title":"오디오 생성 비용 견적","openapi":"POST /audio/quote","href":"/ko/api-reference/endpoint/audio/quote"},{"title":"오디오 완료 처리","openapi":"POST /audio/complete","href":"/ko/api-reference/endpoint/audio/complete"},{"title":"보이스 체인저 큐","openapi":"POST /audio/voice-changer/queue","href":"/ko/api-reference/endpoint/audio/voice-changer/queue"},{"title":"보이스 체인저 검색","openapi":"POST /audio/voice-changer/retrieve","href":"/ko/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"보이스 체인저 비용 견적","openapi":"POST /audio/voice-changer/quote","href":"/ko/api-reference/endpoint/audio/voice-changer/quote"},{"title":"보이스 체인저 완료 처리","openapi":"POST /audio/voice-changer/complete","href":"/ko/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"비디오","expanded":false,"pages":[{"title":"비디오 생성 큐","openapi":"POST /video/queue","href":"/ko/api-reference/endpoint/video/queue"},{"title":"비디오 검색","openapi":"POST /video/retrieve","href":"/ko/api-reference/endpoint/video/retrieve"},{"title":"비디오 생성 비용 견적","openapi":"POST /video/quote","href":"/ko/api-reference/endpoint/video/quote"},{"title":"비디오 완료 처리","openapi":"POST /video/complete","href":"/ko/api-reference/endpoint/video/complete"}]},{"group":"도구","expanded":false,"pages":[{"title":"텍스트 파서","openapi":"POST /augment/text-parser","href":"/ko/api-reference/endpoint/augment/text-parser"},{"title":"웹 스크래핑","openapi":"POST /augment/scrape","href":"/ko/api-reference/endpoint/augment/scrape"},{"title":"웹 검색","openapi":"POST /augment/search","href":"/ko/api-reference/endpoint/augment/search"},{"title":"Crypto Networks","openapi":"GET /crypto/rpc/networks","href":"/ko/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/ko/api-reference/endpoint/crypto/rpc"}]},{"group":"임베딩","expanded":false,"pages":[{"title":"임베딩 생성","openapi":"POST /embeddings","href":"/ko/api-reference/endpoint/embeddings/generate"}]},{"group":"모델","expanded":false,"pages":[{"title":"모델 목록","openapi":"GET /models","href":"/ko/api-reference/endpoint/models/list"},{"title":"호환성 매핑","openapi":"GET /models/compatibility_mapping","href":"/ko/api-reference/endpoint/models/compatibility_mapping"},{"title":"특성","openapi":"GET /models/traits","href":"/ko/api-reference/endpoint/models/traits"}]},{"group":"API 키","expanded":false,"pages":[{"title":"API 키 목록","openapi":"GET /api_keys","href":"/ko/api-reference/endpoint/api_keys/list"},{"title":"API 키 세부 정보 가져오기","openapi":"GET /api_keys/{id}","href":"/ko/api-reference/endpoint/api_keys/get"},{"title":"API 키 생성","openapi":"POST /api_keys","href":"/ko/api-reference/endpoint/api_keys/create"},{"title":"API 키 업데이트","openapi":"PATCH /api_keys","href":"/ko/api-reference/endpoint/api_keys/update"},{"title":"API 키 삭제","openapi":"DELETE /api_keys","href":"/ko/api-reference/endpoint/api_keys/delete"},{"title":"Web3 지갑으로 API 키 생성","openapi":"GET /api_keys/generate_web3_key","href":"/ko/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Web3 지갑으로 API 키 생성","openapi":"POST /api_keys/generate_web3_key","href":"/ko/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"API 키 속도 제한","expanded":false,"pages":[{"title":"속도 제한 및 잔액","openapi":"GET /api_keys/rate_limits","href":"/ko/api-reference/endpoint/api_keys/rate_limits"},{"title":"속도 제한 로그","openapi":"GET /api_keys/rate_limits/log","href":"/ko/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"캐릭터","expanded":false,"pages":[{"title":"캐릭터 가져오기","openapi":"GET /characters/{slug}","href":"/ko/api-reference/endpoint/characters/get"},{"title":"캐릭터 목록","openapi":"GET /characters","href":"/ko/api-reference/endpoint/characters/list"},{"title":"캐릭터 리뷰 목록","openapi":"GET /characters/{slug}/reviews","href":"/ko/api-reference/endpoint/characters/reviews"}]},{"group":"결제","expanded":false,"pages":[{"title":"청구 잔액","openapi":"GET /billing/balance","href":"/ko/api-reference/endpoint/billing/balance"},{"title":"청구 사용량 (제거됨)","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":"/ko/api-reference/endpoint/billing/usage"},{"title":"청구 사용량 분석 (Beta)","openapi":"GET /billing/usage-analytics","href":"/ko/api-reference/endpoint/billing/usage-analytics"},{"title":"청구 사용 내역","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":"/ko/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"X402 잔액","openapi":"GET /x402/balance/{walletAddress}","href":"/ko/api-reference/endpoint/x402/balance"},{"title":"X402 충전","openapi":"POST /x402/top-up","href":"/ko/api-reference/endpoint/x402/top-up"},{"title":"X402 트랜잭션","openapi":"GET /x402/transactions/{walletAddress}","href":"/ko/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"변경 사항","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"상태","icon":"activity","href":"https://veniceai-status.com"}]}]},"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"]}