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>"
}
هذه endpoint بيتا وقد تكون غير مستقرة أو تتغير دون إشعار.
احصل على تحليلات استخدام مُجمَّعة للمستخدم المُصادَق عليه، مع تفصيل حسب التاريخ والنموذج ومفتاح API. توفّر هذه الـ endpoint عروض ملخّصة لبيانات استخدام API لبناء لوحات المعلومات ومراقبة الاستهلاك. يتم تخزين البيانات مؤقتًا لمدة 10 دقائق.
يمكنك تحديد الفترة الزمنية للتحليلات باستخدام إما:
lookback: فترة نسبية مثل “7d” (7 أيام)، “30d” (30 يومًا)، حتى “90d” (90 يومًا)
startDate و endDate: نطاق تاريخ مخصص بصيغة YYYY-MM-DD. أرسل كليهما لاستخدام نطاق مخصص.
إذا لم يتم تحديد أي معاملات، فإن فترة lookback الافتراضية هي 7 أيام.
إذا أرسلت startDate أو endDate وحده فقط، فلن يفشل الطلب: إذ يُعيد 200 باستخدام فترة lookback الافتراضية البالغة 7 أيام ويتجاهل التاريخ، دون أي تحذير. أرسل الاثنين معًا دائمًا.تُقيَّد قيمة lookback التي تتجاوز 90 يومًا عند 90d. أما نطاق startDate/endDate الذي يتجاوز 90 يومًا فيُعيد 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":"6aeba83883de95559c37383e","collectionId":"ba70b5b5-5a7f-43a9-aa61-8b1e89b3fc36","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeba83883de95559c37383e"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeba83883de95559c37383e","clientVersion":"0.0.4067","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/38e9692f6f9630fd/style.css"}],"page":{"pagePath":"ar/api-reference/endpoint/billing/usage-analytics","slug":"/ar/api-reference/endpoint/billing/usage-analytics","pageMetadata":{"title":"تحليلات استخدام الفوترة (بيتا)","openapi":"GET /billing/usage-analytics","og:title":"تحليلات استخدام الفوترة | Venice API Docs","og:description":"احصل على تحليلات استخدام مُجمَّعة مع تفصيل حسب التاريخ والنموذج ومفتاح API.","description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","href":"/ar/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:`هذه endpoint بيتا وقد تكون غير مستقرة أو تتغير دون إشعار.`})}),`\n`,_jsx(_components.p,{children:`احصل على تحليلات استخدام مُجمَّعة للمستخدم المُصادَق عليه، مع تفصيل حسب التاريخ والنموذج ومفتاح API. توفّر هذه الـ endpoint عروض ملخّصة لبيانات استخدام 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`}),` وحده فقط، فلن يفشل الطلب: إذ يُعيد `,_jsx(_components.code,{children:`200`}),` باستخدام فترة lookback الافتراضية البالغة 7 أيام ويتجاهل التاريخ، دون أي تحذير. أرسل الاثنين معًا دائمًا.`]}),_jsxs(_components.p,{children:[`تُقيَّد قيمة `,_jsx(_components.code,{children:`lookback`}),` التي تتجاوز 90 يومًا عند `,_jsx(_components.code,{children:`90d`}),`. أما نطاق `,_jsx(_components.code,{children:`startDate`}),`/`,_jsx(_components.code,{children:`endDate`}),` الذي يتجاوز 90 يومًا فيُعيد `,_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`}),`: إجمالي الاستخدام بالدولار الأمريكي لذلك اليوم`]}),`\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`}),`: إجمالي الدولارات المُنفَقة على هذا النموذج`]}),`\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`}),`: نوع الـ token (مثل “Input”، “Output”، “Cache Read”، “Cache Write”)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`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، أو null إذا كان الاستخدام من تطبيق الويب`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`description`}),`: وصف مفتاح API أو “Web App”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`totalUsd`}),`: إجمالي الدولارات المُنفَقة عبر هذا المفتاح`]}),`\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":"تحليلات استخدام الفوترة (بيتا)","openapi":"GET /billing/usage-analytics","og:title":"تحليلات استخدام الفوترة | Venice API Docs","og:description":"احصل على تحليلات استخدام مُجمَّعة مع تفصيل حسب التاريخ والنموذج ومفتاح API.","description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","href":"/ar/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":["eee05a00-9018-43fe-b66b-ed1ad7ed7915","c7163522-89b0-4825-a39b-37bcad5aa5a5","4b4718b7-6061-469a-8ddf-b9a857eddffa"],"responses":{"200":"bde3c2b0-999c-4343-aad7-ba6731aac536","400":"1a6063a4-1135-49bc-8826-3826b8ac3fc8","401":"425dfa5f-8ba5-422b-a47c-211d02b1c4ae","403":"8635f966-1132-4f65-be43-2c2585d5ec30","500":"99df9149-3373-4fac-a557-6502dd40942e","504":"59f87729-5f45-40fa-ac2a-b71f0687af14"},"method":"get","type":"path","servers":["96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d"],"security":["5ae61ed6-c925-4e36-a3b5-59b7cd2707f3"],"path":"/billing/usage-analytics","baseUrlOptions":["https://api.venice.ai/api/v1"],"title":"/api/v1/billing/usage-analytics","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"eee05a00-9018-43fe-b66b-ed1ad7ed7915":{"schema":{"type":"string","pattern":"^[1-9]\\d*d$","default":"7d","description":"Lookback period for usage data. Format: number followed by \"d\" (e.g., \"7d\", \"30d\"). Maximum: 90d","example":"7d","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"lookback","in":"query"},"c7163522-89b0-4825-a39b-37bcad5aa5a5":{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date for filtering records (YYYY-MM-DD). If provided, endDate is also required.","example":"2024-01-01T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"startDate","in":"query"},"4b4718b7-6061-469a-8ddf-b9a857eddffa":{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date for filtering records (YYYY-MM-DD). If provided, startDate is also required.","example":"2024-01-31T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"endDate","in":"query"}},"responses":{"bde3c2b0-999c-4343-aad7-ba6731aac536":{"description":"Successful response with aggregated usage analytics","content":{"application/json":{"schema":{"type":"object","properties":{"lookback":{"type":"string","description":"The lookback period used for the query. Either \"Nd\" format or \"startDate:endDate\" format.","example":"7d","isRequired":true,"uniqueKey":"lookback","typeLabel":"string"},"byDate":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format","example":"2024-01-15T00:00:00.000Z","isRequired":true,"uniqueKey":"byDate.items.[INDEX].date","typeLabel":"string"},"USD":{"type":"number","description":"Total USD usage for this date","isRequired":true,"uniqueKey":"byDate.items.[INDEX].USD","typeLabel":"number"},"DIEM":{"type":"number","description":"Total DIEM usage for this date","isRequired":true,"uniqueKey":"byDate.items.[INDEX].DIEM","typeLabel":"number"}},"required":["date","USD","DIEM"],"uniqueKey":"byDate.items.[INDEX]","typeLabel":"object"},"description":"Daily usage totals for the requested period","isRequired":true,"uniqueKey":"byDate","typeLabel":"object[]"},"byModel":{"type":"array","items":{"type":"object","properties":{"modelName":{"type":"string","description":"Display name of the model","example":"GLM 5.1","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelName","typeLabel":"string"},"unitType":{"type":"string","description":"Type of units (tokens, images, chars, minutes, seconds)","example":"tokens","isRequired":true,"uniqueKey":"byModel.items.[INDEX].unitType","typeLabel":"string"},"modelType":{"oneOf":[{"type":"string","description":"Type of model (LLM, IMAGE, TTS, ASR, VIDEO)","example":"LLM","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of model (LLM, IMAGE, TTS, ASR, VIDEO)","example":"LLM","isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"byModel.items.[INDEX].modelType","typeLabel":"string | null"},"totalUsd":{"type":"number","description":"Total USD usage for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalUsd","typeLabel":"number"},"totalDiem":{"type":"number","description":"Total DIEM usage for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalDiem","typeLabel":"number"},"totalUnits":{"type":"number","description":"Total units consumed for this model","isRequired":true,"uniqueKey":"byModel.items.[INDEX].totalUnits","typeLabel":"number"},"breakdown":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Token type (e.g., \"Input\", \"Output\", \"Cache Read\", \"Cache Write\")","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].type","typeLabel":"string"},"usd":{"type":"number","description":"USD amount for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].usd","typeLabel":"number"},"diem":{"type":"number","description":"DIEM amount for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].diem","typeLabel":"number"},"units":{"type":"number","description":"Number of units for this breakdown","isRequired":true,"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX].units","typeLabel":"number"}},"required":["type","usd","diem","units"],"uniqueKey":"byModel.items.[INDEX].breakdown.items.[INDEX]","typeLabel":"object"},"description":"Breakdown by token type (only present if multiple types)","uniqueKey":"byModel.items.[INDEX].breakdown","typeLabel":"object[]"}},"required":["modelName","unitType","modelType","totalUsd","totalDiem","totalUnits"],"uniqueKey":"byModel.items.[INDEX]","typeLabel":"object"},"description":"Usage breakdown by model, sorted by total spend (highest first)","isRequired":true,"uniqueKey":"byModel","typeLabel":"object[]"},"byModelDaily":{"type":"array","items":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"byModelDaily.items.[INDEX].additionalProperties","typeLabel":"number"},"uniqueKey":"byModelDaily.items.[INDEX]","typeLabel":"object"},"description":"Daily chart data for top 8 models. Each entry has \"date\" (timestamp) plus model names as keys.","isRequired":true,"uniqueKey":"byModelDaily","typeLabel":"object[]"},"topModels":{"type":"array","items":{"type":"string","uniqueKey":"topModels.items.[INDEX]","typeLabel":"string"},"description":"Names of the top 8 models by usage (for chart legends)","isRequired":true,"uniqueKey":"topModels","typeLabel":"string[]"},"byKey":{"type":"array","items":{"type":"object","properties":{"apiKeyId":{"oneOf":[{"type":"string","description":"API key ID, or null if usage was from web app","isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId.oneOf.0","typeLabel":"string"},{"type":"null","description":"API key ID, or null if usage was from web app","isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"byKey.items.[INDEX].apiKeyId","typeLabel":"string | null"},"description":{"type":"string","description":"API key description or \"Web App\"","example":"My Production Key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].description","typeLabel":"string"},"totalUsd":{"type":"number","description":"Total USD usage for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalUsd","typeLabel":"number"},"totalDiem":{"type":"number","description":"Total DIEM usage for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalDiem","typeLabel":"number"},"totalUnits":{"type":"number","description":"Total units consumed for this key","isRequired":true,"uniqueKey":"byKey.items.[INDEX].totalUnits","typeLabel":"number"}},"required":["apiKeyId","description","totalUsd","totalDiem","totalUnits"],"uniqueKey":"byKey.items.[INDEX]","typeLabel":"object"},"description":"Usage breakdown by API key, sorted by total spend (highest first)","isRequired":true,"uniqueKey":"byKey","typeLabel":"object[]"},"byKeyDaily":{"type":"array","items":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"byKeyDaily.items.[INDEX].additionalProperties","typeLabel":"number"},"uniqueKey":"byKeyDaily.items.[INDEX]","typeLabel":"object"},"description":"Daily chart data for top 8 API keys. Each entry has \"date\" (timestamp) plus key descriptions as keys.","isRequired":true,"uniqueKey":"byKeyDaily","typeLabel":"object[]"},"topKeyNames":{"type":"array","items":{"type":"string","uniqueKey":"topKeyNames.items.[INDEX]","typeLabel":"string"},"description":"Descriptions of the top 8 API keys by usage (for chart legends)","isRequired":true,"uniqueKey":"topKeyNames","typeLabel":"string[]"}},"required":["lookback","byDate","byModel","byModelDaily","topModels","byKey","byKeyDaily","topKeyNames"],"additionalProperties":false,"description":"Aggregated usage analytics response with breakdowns by date, model, and API key","example":{"lookback":"7d","byDate":[{"date":"2024-01-15T00:00:00.000Z","USD":0.5,"DIEM":10.25},{"date":"2024-01-14T00:00:00.000Z","USD":0.3,"DIEM":8.75}],"byModel":[{"modelName":"GLM 5.1","unitType":"tokens","modelType":"LLM","totalUsd":0.4,"totalDiem":12.5,"totalUnits":50000,"breakdown":[{"type":"Output","usd":0.3,"diem":10,"units":35000},{"type":"Input","usd":0.1,"diem":2.5,"units":15000}]}],"byModelDaily":[{"date":1705276800000,"GLM 5.1":5.5,"Kimi K2.6":3.2}],"topModels":["GLM 5.1","Kimi K2.6"],"byKey":[{"apiKeyId":"key_abc123","description":"Production Key","totalUsd":0.8,"totalDiem":15,"totalUnits":75000},{"apiKeyId":null,"description":"Web App","totalUsd":0,"totalDiem":4,"totalUnits":25000}],"byKeyDaily":[{"date":1705276800000,"Production Key":8.5,"Web App":2}],"topKeyNames":["Production Key","Web App"]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"lookback":"7d","byDate":[{"date":"2024-01-15T00:00:00.000Z","USD":0.5,"DIEM":10.25},{"date":"2024-01-14T00:00:00.000Z","USD":0.3,"DIEM":8.75}],"byModel":[{"modelName":"GLM 5.1","unitType":"tokens","modelType":"LLM","totalUsd":0.4,"totalDiem":12.5,"totalUnits":50000,"breakdown":[{"type":"Output","usd":0.3,"diem":10,"units":35000},{"type":"Input","usd":0.1,"diem":2.5,"units":15000}]}],"byModelDaily":[{"date":1705276800000,"GLM 5.1":5.5,"Kimi K2.6":3.2}],"topModels":["GLM 5.1","Kimi K2.6"],"byKey":[{"apiKeyId":"key_abc123","description":"Production Key","totalUsd":0.8,"totalDiem":15,"totalUnits":75000},{"apiKeyId":null,"description":"Web App","totalUsd":0,"totalDiem":4,"totalUnits":25000}],"byKeyDaily":[{"date":1705276800000,"Production Key":8.5,"Web App":2}],"topKeyNames":["Production Key","Web App"]}}},"exampleType":"generated"}},"exampleType":"generated"},"1a6063a4-1135-49bc-8826-3826b8ac3fc8":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","properties":{},"description":"Details about the incorrect input","example":{"_errors":[],"field":{"_errors":["Field is required"]}},"uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{"_errors":[],"field":{"_errors":["Field is required"]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"425dfa5f-8ba5-422b-a47c-211d02b1c4ae":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8635f966-1132-4f65-be43-2c2585d5ec30":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["This API key is restricted to configured IP addresses, and this request's source IP is not allowed"],"description":"A description of the error","example":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed"}}},"exampleType":"generated"}},"description":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","exampleType":"generated"},"99df9149-3373-4fac-a557-6502dd40942e":{"description":"Inference processing failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"59f87729-5f45-40fa-ac2a-b71f0687af14":{"description":"Query timed out - try reducing the lookback period","content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message indicating query timeout","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5ae61ed6-c925-4e36-a3b5-59b7cd2707f3":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d":{"url":"https://api.venice.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"swagger.yaml"},"subdomain":"veniceai","siteName":"Venice API Docs","title":"تحليلات استخدام الفوترة | 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":0},"it":{"href":"/it/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"de":{"href":"/de/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"es":{"href":"/es/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"fr":{"href":"/fr/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"zh":{"href":"/zh/api-reference/endpoint/billing/usage-analytics","matchLevel":1},"ko":{"href":"/ko/api-reference/endpoint/billing/usage-analytics","matchLevel":1}}},"lastModified":"2026-10-20T21:53:07.160Z","originalFileLocation":"ar/api-reference/endpoint/billing/usage-analytics.mdx","locale":"ar"},"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=\"تحليلات استخدام الفوترة | Venice API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"احصل على تحليلات استخدام مُجمَّعة مع تفصيل حسب التاريخ والنموذج ومفتاح API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/ar/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=%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\u0026amp;title=%D8%AA%D8%AD%D9%84%D9%8A%D9%84%D8%A7%D8%AA+%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85+%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9+%28%D8%A8%D9%8A%D8%AA%D8%A7%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=86a406b83a8db6ca19dbbdeb54bf745df650d294d4d1df01e9cfca5de5781443\">\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=\"تحليلات استخدام الفوترة | Venice API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"احصل على تحليلات استخدام مُجمَّعة مع تفصيل حسب التاريخ والنموذج ومفتاح API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\u0026amp;title=%D8%AA%D8%AD%D9%84%D9%8A%D9%84%D8%A7%D8%AA+%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85+%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9+%28%D8%A8%D9%8A%D8%AA%D8%A7%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=86a406b83a8db6ca19dbbdeb54bf745df650d294d4d1df01e9cfca5de5781443\">\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/ar/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=\"/ar/api-reference/endpoint/billing/usage-analytics.md\">\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=\"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=\"it\" href=\"https://docs.venice.ai/it/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.venice.ai/zh/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-analytics\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.venice.ai/#organization\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.venice.ai#website\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics#webpage\",\"url\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics\",\"name\":\"تحليلات استخدام الفوترة (بيتا)\",\"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:07.160Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/ar/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"الفوترة\",\"item\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"تحليلات استخدام الفوترة (بيتا)\",\"item\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics#apireference\",\"headline\":\"تحليلات استخدام الفوترة (بيتا)\",\"name\":\"تحليلات استخدام الفوترة (بيتا)\",\"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/ar/api-reference/endpoint/billing/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-analytics#webpage\"},\"dateModified\":\"2026-10-20T21:53:07.160Z\",\"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","tabs":[{"tab":"التوثيق","icon":"book","pages":[{"title":"التوثيق","href":"/ar/overview/about-venice"}]},{"tab":"النماذج","icon":"box","pages":[{"title":"النماذج","href":"/ar/models/overview"}]},{"tab":"تعلّم","icon":"layout-grid","pages":[{"title":"تعلّم","href":"/ar/learn"}]},{"tab":"مرجع الـ API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"مقدمة","href":"/ar/api-reference/api-spec"},{"title":"حدود المعدل","href":"/ar/api-reference/rate-limiting"},{"title":"رموز الأخطاء","href":"/ar/api-reference/error-codes"},{"group":"الدردشة","expanded":false,"pages":[{"title":"إكمال المحادثات","openapi":"POST /chat/completions","href":"/ar/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/ar/api-reference/endpoint/responses/create"},{"title":"لاحقة ميزات النموذج","href":"/ar/api-reference/endpoint/chat/model_feature_suffix"},{"title":"إنشاء القرارات","openapi":"POST /decisions","href":"/ar/api-reference/endpoint/decisions/create"},{"title":"التوافق مع System One","openapi":"POST /systemone","href":"/ar/api-reference/endpoint/decisions/systemone"}]},{"group":"الصور","expanded":false,"pages":[{"title":"توليد الصور","openapi":"POST /image/generate","href":"/ar/api-reference/endpoint/image/generate"},{"title":"تكبير الصور وتحسينها","openapi":"POST /image/upscale","href":"/ar/api-reference/endpoint/image/upscale"},{"title":"تحرير (المعروف بـ Inpaint)","openapi":"POST /image/edit","href":"/ar/api-reference/endpoint/image/edit"},{"title":"تحرير الصور المتعدد","openapi":"POST /image/multi-edit","href":"/ar/api-reference/endpoint/image/multi-edit"},{"title":"إزالة الخلفية","openapi":"POST /image/background-remove","href":"/ar/api-reference/endpoint/image/background-remove"},{"title":"أنماط الصور","openapi":"GET /image/styles","href":"/ar/api-reference/endpoint/image/styles"},{"title":"توليد الصور (واجهة متوافقة مع OpenAI)","openapi":"POST /images/generations","href":"/ar/api-reference/endpoint/image/generations"}]},{"group":"الصوت","expanded":false,"pages":[{"title":"واجهة Speech API (تجريبية)","openapi":"POST /audio/speech","href":"/ar/api-reference/endpoint/audio/speech"},{"title":"استنساخ الصوت","openapi":"POST /audio/voices","href":"/ar/api-reference/endpoint/audio/voices"},{"title":"واجهة Transcriptions API (تجريبية)","openapi":"POST /audio/transcriptions","href":"/ar/api-reference/endpoint/audio/transcriptions"},{"title":"وضع توليد الصوت في قائمة الانتظار","openapi":"POST /audio/queue","href":"/ar/api-reference/endpoint/audio/queue"},{"title":"استرجاع الصوت","openapi":"POST /audio/retrieve","href":"/ar/api-reference/endpoint/audio/retrieve"},{"title":"تسعير توليد الصوت","openapi":"POST /audio/quote","href":"/ar/api-reference/endpoint/audio/quote"},{"title":"إكمال الصوت","openapi":"POST /audio/complete","href":"/ar/api-reference/endpoint/audio/complete"},{"title":"وضع تغيير الصوت في قائمة الانتظار","openapi":"POST /audio/voice-changer/queue","href":"/ar/api-reference/endpoint/audio/voice-changer/queue"},{"title":"استرجاع تغيير الصوت","openapi":"POST /audio/voice-changer/retrieve","href":"/ar/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"تسعير تغيير الصوت","openapi":"POST /audio/voice-changer/quote","href":"/ar/api-reference/endpoint/audio/voice-changer/quote"},{"title":"إكمال تغيير الصوت","openapi":"POST /audio/voice-changer/complete","href":"/ar/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"الفيديو","expanded":false,"pages":[{"title":"وضع توليد الفيديو في قائمة الانتظار","openapi":"POST /video/queue","href":"/ar/api-reference/endpoint/video/queue"},{"title":"استرجاع الفيديو","openapi":"POST /video/retrieve","href":"/ar/api-reference/endpoint/video/retrieve"},{"title":"تسعير توليد الفيديو","openapi":"POST /video/quote","href":"/ar/api-reference/endpoint/video/quote"},{"title":"إكمال الفيديو","openapi":"POST /video/complete","href":"/ar/api-reference/endpoint/video/complete"}]},{"group":"الأدوات","expanded":false,"pages":[{"title":"محلِّل النصوص","openapi":"POST /augment/text-parser","href":"/ar/api-reference/endpoint/augment/text-parser"},{"title":"استخراج محتوى الويب","openapi":"POST /augment/scrape","href":"/ar/api-reference/endpoint/augment/scrape"},{"title":"البحث في الويب","openapi":"POST /augment/search","href":"/ar/api-reference/endpoint/augment/search"},{"title":"شبكات Crypto","openapi":"GET /crypto/rpc/networks","href":"/ar/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/ar/api-reference/endpoint/crypto/rpc"}]},{"group":"التضمينات","expanded":false,"pages":[{"title":"إنشاء Embeddings","openapi":"POST /embeddings","href":"/ar/api-reference/endpoint/embeddings/generate"}]},{"group":"النماذج","expanded":false,"pages":[{"title":"قائمة النماذج","openapi":"GET /models","href":"/ar/api-reference/endpoint/models/list"},{"title":"خريطة التوافق","openapi":"GET /models/compatibility_mapping","href":"/ar/api-reference/endpoint/models/compatibility_mapping"},{"title":"سمات النماذج","openapi":"GET /models/traits","href":"/ar/api-reference/endpoint/models/traits"}]},{"group":"مفاتيح الـ API","expanded":false,"pages":[{"title":"قائمة مفاتيح API","openapi":"GET /api_keys","href":"/ar/api-reference/endpoint/api_keys/list"},{"title":"الحصول على تفاصيل مفتاح API","openapi":"GET /api_keys/{id}","href":"/ar/api-reference/endpoint/api_keys/get"},{"title":"إنشاء مفتاح API","openapi":"POST /api_keys","href":"/ar/api-reference/endpoint/api_keys/create"},{"title":"تحديث مفتاح API","openapi":"PATCH /api_keys","href":"/ar/api-reference/endpoint/api_keys/update"},{"title":"حذف مفتاح API","openapi":"DELETE /api_keys","href":"/ar/api-reference/endpoint/api_keys/delete"},{"title":"إنشاء مفتاح API بمحفظة Web3","openapi":"GET /api_keys/generate_web3_key","href":"/ar/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"إنشاء مفتاح API بمحفظة Web3","openapi":"POST /api_keys/generate_web3_key","href":"/ar/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"حدود معدّل مفاتيح الـ API","expanded":false,"pages":[{"title":"حدود المعدل والأرصدة","openapi":"GET /api_keys/rate_limits","href":"/ar/api-reference/endpoint/api_keys/rate_limits"},{"title":"سجلات حدود المعدل","openapi":"GET /api_keys/rate_limits/log","href":"/ar/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"الشخصيات","expanded":false,"pages":[{"title":"الحصول على شخصية","openapi":"GET /characters/{slug}","href":"/ar/api-reference/endpoint/characters/get"},{"title":"قائمة الشخصيات","openapi":"GET /characters","href":"/ar/api-reference/endpoint/characters/list"},{"title":"قائمة مراجعات الشخصيات","openapi":"GET /characters/{slug}/reviews","href":"/ar/api-reference/endpoint/characters/reviews"}]},{"group":"الفوترة","expanded":false,"pages":[{"title":"رصيد الفوترة","openapi":"GET /billing/balance","href":"/ar/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":"/ar/api-reference/endpoint/billing/usage"},{"title":"تحليلات استخدام الفوترة (بيتا)","openapi":"GET /billing/usage-analytics","href":"/ar/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":"/ar/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"رصيد X402","openapi":"GET /x402/balance/{walletAddress}","href":"/ar/api-reference/endpoint/x402/balance"},{"title":"شحن رصيد X402","openapi":"POST /x402/top-up","href":"/ar/api-reference/endpoint/x402/top-up"},{"title":"معاملات X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/ar/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"سجل التغييرات","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"الحالة","icon":"activity","href":"https://veniceai-status.com"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/endpoint/billing/usage-analytics"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/endpoint/billing/usage-analytics"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoint/billing/usage-analytics"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/endpoint/billing/usage-analytics"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/endpoint/billing/usage-analytics"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/endpoint/billing/usage-analytics"}]}]},"basePath":"","title":"تحليلات استخدام الفوترة | Venice API Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}