{ "success": false, "error": { "code": "range_too_large", "message": "Time range must not exceed 31 days.", "type": "usage_query_error" }}
Utilice una API Key para consultar los gastos de un período, con filtros por modelo y agrupación por modelo, día natural o ambos. El resultado agregado se devuelve directamente, sin crear tareas ni consultar su estado periódicamente.
Utilice la misma API Key que para llamar a los modelos, con autenticación Bearer Token. Obtenga la clave en la página de gestión de API Keys.
Authorization: Bearer YOUR_API_KEY
La consulta funciona incluso con saldo 0. No se comprueba el saldo, pero sí el estado y la caducidad de la clave, la lista de IP permitidas y el estado de la cuenta.
Inicio del período, incluido. Admite un timestamp Unix en segundos o una cadena RFC3339 con zona horaria, como 2026-09-01T00:00:00+08:00.Si se omite, se usan 24 horas antes de end. Los timestamps están en segundos, no milisegundos.
Fin del período, excluido. Mismo formato que start; si se omite, se usa la hora actual.Debe ser posterior a start, y end - start no puede superar 31 días.
Nombre del modelo. Si se omite, se incluyen todos los modelos. Separe varios modelos con comas; máximo 50.Coincidencia exacta sin distinguir mayúsculas y minúsculas. No admite comodines.Ejemplo: gpt-5.6-luna,sora-2
Nombre de zona horaria IANA. Predeterminado: Asia/Shanghai.Solo afecta a los límites de los días cuando group_by incluye date; no cambia los instantes de inicio y fin. Las horas RFC3339 se interpretan según su propia zona horaria.
account: todas las API Keys de la cuenta a la que pertenece la clave actual
El intervalo es [start, end): incluye el inicio y excluye el final. Use el mismo instante para el end de la consulta anterior y el start de la siguiente para evitar duplicar el límite.Al construir la URL manualmente, codifique el + de RFC3339 como %2B. cURL --data-urlencode, Python params y JavaScript URLSearchParams en los ejemplos lo hacen automáticamente.
Detalles agrupados en orden descendente de amount_usd. Array vacío si group_by=none. Cada elemento contiene los campos estadísticos de la tabla siguiente.
Si group_by incluye model, el elemento contiene model
Si group_by incluye date, el elemento contiene date en formato YYYY-MM-DD; los días se delimitan según tz
data.total y data.items[] comparten estos campos estadísticos:
Campo
Tipo
Descripción
amount_usd
number
Importe en USD, redondeado a 6 decimales
credits
number
Créditos del servicio: amount_usd × 10, la misma unidad que en el sitio web
requests
integer
Número de llamadas facturadas correctamente
prompt_tokens
integer
Tokens de entrada; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo
completion_tokens
integer
Tokens de salida; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo
En errores de consulta de uso, contiene code, message y type, donde type es usage_query_error. Los errores de autenticación 401 / 403 los devuelve la capa de autenticación.
Basado en llamadas facturadas correctamente, con los mismos datos que el panel del sitio web
Se excluyen llamadas fallidas y tareas reembolsadas tras un fallo; no es necesario compensarlas manualmente. Los lotes de imágenes parcialmente completados se cobran según las imágenes realmente entregadas
Se usa el momento de contabilización del cobro. Las tareas asíncronas de imagen y vídeo se contabilizan al finalizar, no al enviarse; las que cruzan la medianoche pertenecen al día de finalización
Una API Key recreada tras eliminarla es una clave nueva. Su consulta scope=key no incluye el historial de la anterior
Los ajustes manuales de saldo no son gastos de llamadas y se excluyen
Están disponibles los datos posteriores al 27 de abril de 2026
Más de 31 días; divida el período en varias consultas
400
invalid_tz
Zona horaria IANA desconocida
400
invalid_group_by
Agrupación no válida
400
invalid_scope
Ámbito no válido
400
too_many_models
Más de 50 modelos
401 / 403
—
API Key no válida o caducada, IP no permitida o cuenta desactivada
429
—
Más de 60 consultas por clave por minuto o límite global de la API
503
usage_unavailable
Datos temporalmente no disponibles; inténtelo más tarde
503 usage_unavailable no devuelve importes. Significa que la consulta no está disponible, no que los gastos sean 0. No convierta respuestas fallidas en importes cero ni sobrescriba un resultado anterior correcto.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"APIMart","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"favicon":"https://mintcdn.com/apicore/1GnRrmOhqkTFCvFb/logo/logo.png?fit=max\u0026auto=format\u0026n=1GnRrmOhqkTFCvFb\u0026q=85\u0026s=609be15c3f1f4e4b765c5945c2871ae9","navbar":{"links":[{"icon":"x-twitter","href":"https://x.com/APIMart_","label":""},{"icon":"discord","href":"https://discord.gg/V8zqssyZ5c","label":""},{"icon":"weixin","href":"https://cdn.apimart.ai/social-media/wechat.jpg","label":""}],"primary":{"type":"button","label":"Dashboard","href":"https://apimart.ai"}},"footer":{"socials":{"x":"https://x.com/APIMart_","website":"https://apimart.ai","discord":"https://discord.gg/V8zqssyZ5c"}},"seo":{"metatags":{"og:site_name":"APIMart","og:type":"website","keywords":"OpenAI compatible, API gateway, GPT-5, Claude, Gemini, multi-provider, transparent pricing, SLA","twitter:card":"summary_large_image","twitter:site":"@APIMart_","twitter:creator":"@APIMart_"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"en"},{"language":"zh-Hans","href":"cn"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"ru","href":"ru"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"pt","href":"pt"},{"language":"id","href":"id"},{"language":"es","href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apicore","hasAudioNarration":false,"actualSubdomain":"apicore","customDomains":["docs.apimart.ai"],"gitSource":{"type":"github","owner":"zhihong-apimart","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb20ce09adb9872106f089","collectionId":"301329eb-6159-43e8-b9f0-94082f867850","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb20ce09adb9872106f089"},"entitlements":{},"buildId":"6adb20ce09adb9872106f089","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"zh-Hans","tag":"API 手册","count":160},{"language":"de","tag":"API-Handbuch","count":160},{"language":"en","tag":"API Manual","count":160},{"language":"es","tag":"Manual de la API","count":160},{"language":"fr","tag":"Manuel API","count":160},{"language":"id","tag":"Panduan API","count":160},{"language":"ja","tag":"APIマニュアル","count":160},{"language":"ko","tag":"API 매뉴얼","count":160},{"language":"pt","tag":"Manual da API","count":160},{"language":"ru","tag":"Руководство API","count":160},{"language":"zh-Hans","tag":"音频系列","count":51},{"language":"de","tag":"Audioserie","count":51},{"language":"en","tag":"Audio Series","count":51},{"language":"es","tag":"Serie de audio","count":51},{"language":"fr","tag":"Série Audio","count":51},{"language":"id","tag":"Seri Audio","count":51},{"language":"ja","tag":"オーディオシリーズ","count":51},{"language":"ko","tag":"오디오 시리즈","count":51},{"language":"pt","tag":"Série de Áudio","count":51},{"language":"ru","tag":"Аудиосерия","count":51},{"language":"zh-Hans","tag":"图像系列","count":49},{"language":"de","tag":"Bildserie","count":49},{"language":"en","tag":"Image Series","count":49},{"language":"es","tag":"Serie de imágenes","count":49},{"language":"fr","tag":"Série Image","count":49},{"language":"id","tag":"Seri Gambar","count":49},{"language":"ja","tag":"画像シリーズ","count":49},{"language":"ko","tag":"이미지 시리즈","count":49},{"language":"pt","tag":"Série de Imagem","count":49},{"language":"ru","tag":"Серия изображений","count":49},{"language":"zh-Hans","tag":"视频系列","count":42},{"language":"de","tag":"Videoserie","count":42},{"language":"en","tag":"Video Series","count":42},{"language":"es","tag":"Serie de video","count":42},{"language":"fr","tag":"Série Vidéo","count":42},{"language":"id","tag":"Seri Video","count":42},{"language":"ja","tag":"動画シリーズ","count":42},{"language":"ko","tag":"비디오 시리즈","count":42},{"language":"pt","tag":"Série de Vídeo","count":42},{"language":"ru","tag":"Видеосерия","count":42},{"language":"zh-Hans","tag":"Suno","count":35},{"language":"de","tag":"Suno","count":35},{"language":"en","tag":"Suno","count":35},{"language":"es","tag":"Suno","count":35},{"language":"fr","tag":"Suno","count":35},{"language":"id","tag":"Suno","count":35},{"language":"ja","tag":"Suno","count":35},{"language":"ko","tag":"Suno","count":35},{"language":"pt","tag":"Suno","count":35},{"language":"ru","tag":"Suno","count":35},{"language":"zh-Hans","tag":"Midjourney","count":19},{"language":"de","tag":"Midjourney","count":19},{"language":"en","tag":"Midjourney","count":19},{"language":"es","tag":"Midjourney","count":19},{"language":"fr","tag":"Midjourney","count":19},{"language":"id","tag":"Midjourney","count":19},{"language":"ja","tag":"Midjourney","count":19},{"language":"ko","tag":"Midjourney","count":19},{"language":"pt","tag":"Midjourney","count":19},{"language":"ru","tag":"Midjourney","count":19},{"language":"zh-Hans","tag":"Flow Music","count":14},{"language":"de","tag":"Flow Music","count":14},{"language":"en","tag":"Flow Music","count":14},{"language":"es","tag":"Flow Music","count":14},{"language":"fr","tag":"Flow Music","count":14},{"language":"id","tag":"Flow Music","count":14},{"language":"ja","tag":"Flow Music","count":14},{"language":"ko","tag":"Flow Music","count":14},{"language":"pt","tag":"Flow Music","count":14},{"language":"ru","tag":"Flow Music","count":14},{"language":"ja","tag":"よくある質問","count":12},{"language":"ko","tag":"자주 묻는 질문","count":12},{"language":"zh-Hans","tag":"集成指南","count":11},{"language":"de","tag":"Integrationen","count":11},{"language":"en","tag":"Integrations","count":11},{"language":"es","tag":"Integraciones","count":11},{"language":"fr","tag":"Intégrations","count":11},{"language":"id","tag":"Integrasi","count":11},{"language":"ja","tag":"統合ガイド","count":11},{"language":"ko","tag":"통합 가이드","count":11},{"language":"pt","tag":"Integrações","count":11},{"language":"ru","tag":"Интеграции","count":11},{"language":"zh-Hans","tag":"文字系列","count":9},{"language":"de","tag":"Textserie","count":9},{"language":"en","tag":"Text Series","count":9},{"language":"es","tag":"Serie de texto","count":9},{"language":"fr","tag":"Série Texte","count":9},{"language":"id","tag":"Seri Teks","count":9},{"language":"ja","tag":"テキストシリーズ","count":9},{"language":"ko","tag":"텍스트 시리즈","count":9},{"language":"pt","tag":"Série de Texto","count":9},{"language":"ru","tag":"Текстовая серия","count":9},{"language":"zh-Hans","tag":"概览","count":7},{"language":"de","tag":"Übersicht","count":7},{"language":"en","tag":"Overview","count":7},{"language":"es","tag":"Visión general","count":7},{"language":"fr","tag":"Aperçu","count":7},{"language":"id","tag":"Ikhtisar","count":7},{"language":"pt","tag":"Visão Geral","count":7},{"language":"ru","tag":"Обзор","count":7}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[id^=param-] a[href^=\"#param-\"]{display:none}[id^=param-] button[data-component-part=field-name]{display:inline-flex;align-items:center;gap:6px;margin:-2px -4px;padding:2px 4px;border-radius:6px;cursor:copy;user-select:text;transition:background-color 150ms ease}[id^=param-] button[data-component-part=field-name]:hover{background:rgb(37 99 235/8%)}[id^=param-] button[data-component-part=field-name]:not([data-copy-state])::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(100 116 139);-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat;transition:background-color 150ms ease}[id^=param-] button[data-component-part=field-name]:hover::after{background-color:rgb(37 99 235)}[id^=param-] button[data-component-part=field-name][data-copy-state=copied]::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(5 150 105);-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='m5 12 4 4L19 6'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='m5 12 4 4L19 6'/%3E%3C/svg%3E\") center/contain no-repeat}[id^=param-] button[data-component-part=field-name][data-copy-state=failed]::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(220 38 38);-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E\") center/contain no-repeat}html.dark [id^=param-] button[data-component-part=field-name]:not([data-copy-state])::after{background-color:rgb(203 213 225)}"}],"page":{"pagePath":"es/api-reference/account/usage","slug":"/es/api-reference/account/usage","pageMetadata":{"title":"Consultar gastos y uso","description":" - Consultar gastos y estadísticas de llamadas en un período\n- Filtrar por modelo y agrupar por modelo o día natural\n- Consultar la API Key actual o toda la cuenta\n- Obtener importes en USD, créditos, llamadas y tokens ","api":"GET https://api.apimart.ai/v1/usage","href":"/es/api-reference/account/usage"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Consultar gastos y estadísticas de llamadas en un período\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Filtrar por modelo y agrupar por modelo o día natural\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Consultar la API Key actual o toda la cuenta\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Obtener importes en USD, créditos, llamadas y tokens\"\n }), \"\\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Info,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Utilice una API Key para consultar los gastos de un período, con filtros por modelo y agrupación por modelo, día natural o ambos. El resultado agregado se devuelve directamente, sin crear tareas ni consultar su estado periódicamente.`}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`autenticación`,children:`Autenticación`}),`\n`,_jsxs(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:[_jsxs(_components.p,{children:[`Utilice la misma API Key que para llamar a los modelos, con autenticación Bearer Token. Obtenga la clave en la `,_jsx(_components.a,{href:`https://apimart.ai/keys`,children:`página de gestión de API Keys`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer YOUR_API_KEY`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`La consulta funciona incluso con saldo 0. No se comprueba el saldo, pero sí el estado y la caducidad de la clave, la lista de IP permitidas y el estado de la cuenta.`})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /v1/usage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /usage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Ambos endpoints tienen la misma función y admiten CORS. Proteja su API Key y no la exponga en código frontend público.`}),`\n`,_jsx(Heading,{level:`2`,id:`parámetros-de-solicitud`,children:`Parámetros de solicitud`}),`\n`,_jsx(_components.p,{children:`Todos los parámetros se envían en la cadena de consulta de la URL.`}),`\n`,_jsxs(ParamField,{query:`start`,type:`integer | string`,id:`param-start`,children:[_jsxs(_components.p,{children:[`Inicio del período, incluido. Admite un timestamp Unix en segundos o una cadena RFC3339 con zona horaria, como `,_jsx(_components.code,{children:`2026-09-01T00:00:00+08:00`}),`.`]}),_jsxs(_components.p,{children:[`Si se omite, se usan 24 horas antes de `,_jsx(_components.code,{children:`end`}),`. Los timestamps están en segundos, no milisegundos.`]})]}),`\n`,_jsxs(ParamField,{query:`end`,type:`integer | string`,id:`param-end`,children:[_jsxs(_components.p,{children:[`Fin del período, excluido. Mismo formato que `,_jsx(_components.code,{children:`start`}),`; si se omite, se usa la hora actual.`]}),_jsxs(_components.p,{children:[`Debe ser posterior a `,_jsx(_components.code,{children:`start`}),`, y `,_jsx(_components.code,{children:`end - start`}),` no puede superar 31 días.`]})]}),`\n`,_jsxs(ParamField,{query:`model`,type:`string`,id:`param-model`,children:[_jsxs(_components.p,{children:[`Nombre del modelo. Si se omite, se incluyen todos los modelos. Separe varios modelos con comas; máximo `,_jsx(_components.code,{children:`50`}),`.`]}),_jsx(_components.p,{children:`Coincidencia exacta sin distinguir mayúsculas y minúsculas. No admite comodines.`}),_jsxs(_components.p,{children:[`Ejemplo: `,_jsx(_components.code,{children:`gpt-5.6-luna,sora-2`})]})]}),`\n`,_jsxs(ParamField,{query:`group_by`,type:`string`,default:`none`,id:`param-group-by`,children:[_jsx(_components.p,{children:`Agrupación:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`none`}),`: solo el total; `,_jsx(_components.code,{children:`items`}),` es un array vacío`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`model`}),`: por modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`date`}),`: por día natural`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`model,date`}),`: por modelo y día natural`]}),`\n`]})]}),`\n`,_jsxs(ParamField,{query:`tz`,type:`string`,default:`Asia/Shanghai`,id:`param-tz`,children:[_jsxs(_components.p,{children:[`Nombre de zona horaria IANA. Predeterminado: `,_jsx(_components.code,{children:`Asia/Shanghai`}),`.`]}),_jsxs(_components.p,{children:[`Solo afecta a los límites de los días cuando `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`date`}),`; no cambia los instantes de inicio y fin. Las horas RFC3339 se interpretan según su propia zona horaria.`]})]}),`\n`,_jsxs(ParamField,{query:`scope`,type:`string`,default:`key`,id:`param-scope`,children:[_jsx(_components.p,{children:`Ámbito de las estadísticas:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`key`}),`: solo la API Key actual (predeterminado)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`account`}),`: todas las API Keys de la cuenta a la que pertenece la clave actual`]}),`\n`]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`El intervalo es `,_jsx(_components.code,{children:`[start, end)`}),`: incluye el inicio y excluye el final. Use el mismo instante para el `,_jsx(_components.code,{children:`end`}),` de la consulta anterior y el `,_jsx(_components.code,{children:`start`}),` de la siguiente para evitar duplicar el límite.`]}),_jsxs(_components.p,{children:[`Al construir la URL manualmente, codifique el `,_jsx(_components.code,{children:`+`}),` de RFC3339 como `,_jsx(_components.code,{children:`%2B`}),`. cURL `,_jsx(_components.code,{children:`--data-urlencode`}),`, Python `,_jsx(_components.code,{children:`params`}),` y JavaScript `,_jsx(_components.code,{children:`URLSearchParams`}),` en los ejemplos lo hacen automáticamente.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplos-de-solicitud`,children:`Ejemplos de solicitud`}),`\n`,_jsx(Heading,{level:`3`,id:`gastos-de-la-api-key-actual-en-las-últimas-24-horas`,children:`Gastos de la API Key actual en las últimas 24 horas`}),`\n`,_jsx(_components.p,{children:`Sin parámetros de consulta se utilizan el período, ámbito y agrupación predeterminados.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`gastos-diarios-de-toda-la-cuenta-para-modelos-concretos`,children:`Gastos diarios de toda la cuenta para modelos concretos`}),`\n`,_jsx(_components.p,{children:`Consultar los gastos del 11 al 18 de septiembre de 2026, hora de Pekín, sin incluir el 18 de septiembre.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_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:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start=1789056000'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end=1789660800'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'model=gpt-5.6-luna'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'group_by=date'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'scope=account'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'tz=Asia/Shanghai'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`agrupar-por-modelo-y-día-natural`,children:`Agrupar por modelo y día natural`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_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:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start=2026-09-01T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end=2026-09-08T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'model=gpt-5.6-luna,sora-2'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'group_by=model,date'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'tz=Asia/Shanghai'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Cada elemento de `,_jsx(_components.code,{children:`items`}),` contiene tanto `,_jsx(_components.code,{children:`model`}),` como `,_jsx(_components.code,{children:`date`}),` con esta agrupación.`]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-de-respuesta`,children:`Campos de respuesta`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsxs(_components.p,{children:[`Resultado de la consulta: `,_jsx(_components.code,{children:`true`}),` si tiene éxito, `,_jsx(_components.code,{children:`false`}),` si hay un error al consultar el uso.`]})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:[_jsx(_components.p,{children:`Si tiene éxito, devuelve el ámbito, el total y los detalles agrupados.`}),_jsxs(Expandable,{title:`Propiedades de data`,children:[_jsx(ResponseField,{name:`scope`,type:`string`,id:`param-scope-1`,children:_jsxs(_components.p,{children:[`Ámbito: `,_jsx(_components.code,{children:`key`}),` o `,_jsx(_components.code,{children:`account`}),`.`]})}),_jsx(ResponseField,{name:`start`,type:`integer`,id:`param-start-1`,children:_jsx(_components.p,{children:`Inicio efectivo como timestamp Unix en segundos, incluido.`})}),_jsx(ResponseField,{name:`end`,type:`integer`,id:`param-end-1`,children:_jsx(_components.p,{children:`Fin efectivo como timestamp Unix en segundos, excluido.`})}),_jsx(ResponseField,{name:`tz`,type:`string`,id:`param-tz-1`,children:_jsx(_components.p,{children:`Zona horaria para la agrupación por día natural.`})}),_jsx(ResponseField,{name:`group_by`,type:`string`,id:`param-group-by-1`,children:_jsxs(_components.p,{children:[`Agrupación: `,_jsx(_components.code,{children:`none`}),`, `,_jsx(_components.code,{children:`model`}),`, `,_jsx(_components.code,{children:`date`}),` o `,_jsx(_components.code,{children:`model,date`}),`.`]})}),_jsx(ResponseField,{name:`total`,type:`object`,id:`param-total`,children:_jsx(_components.p,{children:`Total del intervalo consultado. Consulte los campos estadísticos en la tabla siguiente.`})}),_jsxs(ResponseField,{name:`items`,type:`object[]`,id:`param-items`,children:[_jsxs(_components.p,{children:[`Detalles agrupados en orden descendente de `,_jsx(_components.code,{children:`amount_usd`}),`. Array vacío si `,_jsx(_components.code,{children:`group_by=none`}),`. Cada elemento contiene los campos estadísticos de la tabla siguiente.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Si `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`model`}),`, el elemento contiene `,_jsx(_components.code,{children:`model`})]}),`\n`,_jsxs(_components.li,{children:[`Si `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`date`}),`, el elemento contiene `,_jsx(_components.code,{children:`date`}),` en formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`; los días se delimitan según `,_jsx(_components.code,{children:`tz`})]}),`\n`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`data.total`}),` y `,_jsx(_components.code,{children:`data.items[]`}),` comparten estos campos estadísticos:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descripción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount_usd`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Importe en USD, redondeado a 6 decimales`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`credits`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Créditos del servicio: `,_jsx(_components.code,{children:`amount_usd × 10`}),`, la misma unidad que en el sitio web`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requests`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Número de llamadas facturadas correctamente`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt_tokens`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Tokens de entrada; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completion_tokens`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Tokens de salida; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo`})]})]})]}),`\n`,_jsx(ResponseField,{name:`error`,type:`object`,id:`param-error`,children:_jsxs(_components.p,{children:[`En errores de consulta de uso, contiene `,_jsx(_components.code,{children:`code`}),`, `,_jsx(_components.code,{children:`message`}),` y `,_jsx(_components.code,{children:`type`}),`, donde `,_jsx(_components.code,{children:`type`}),` es `,_jsx(_components.code,{children:`usage_query_error`}),`. Los errores de autenticación 401 / 403 los devuelve la capa de autenticación.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`límites-y-caché`,children:`Límites y caché`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Máximo `,_jsx(_components.code,{children:`60`}),` consultas por minuto por API Key; también se aplican los límites globales de la API`]}),`\n`,_jsxs(_components.li,{children:[`Los resultados con los mismos parámetros se almacenan en caché durante `,_jsx(_components.code,{children:`60`}),` segundos; la cabecera `,_jsx(_components.code,{children:`X-Usage-Cache`}),` es `,_jsx(_components.code,{children:`hit`}),` o `,_jsx(_components.code,{children:`miss`})]}),`\n`,_jsx(_components.li,{children:`Los gastos suelen estar disponibles en 1 segundo, pero el último minuto puede estar incompleto y la caché puede añadir retrasos`}),`\n`,_jsx(_components.li,{children:`Se recomienda un intervalo mínimo de 1 minuto; no usar como notificación de cobro en tiempo real`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`criterios-de-contabilización`,children:`Criterios de contabilización`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Basado en llamadas facturadas correctamente, con los mismos datos que el panel del sitio web`}),`\n`,_jsx(_components.li,{children:`Se excluyen llamadas fallidas y tareas reembolsadas tras un fallo; no es necesario compensarlas manualmente. Los lotes de imágenes parcialmente completados se cobran según las imágenes realmente entregadas`}),`\n`,_jsx(_components.li,{children:`Se usa el momento de contabilización del cobro. Las tareas asíncronas de imagen y vídeo se contabilizan al finalizar, no al enviarse; las que cruzan la medianoche pertenecen al día de finalización`}),`\n`,_jsxs(_components.li,{children:[`Una API Key recreada tras eliminarla es una clave nueva. Su consulta `,_jsx(_components.code,{children:`scope=key`}),` no incluye el historial de la anterior`]}),`\n`,_jsx(_components.li,{children:`Los ajustes manuales de saldo no son gastos de llamadas y se excluyen`}),`\n`,_jsx(_components.li,{children:`Están disponibles los datos posteriores al 27 de abril de 2026`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`gestión-de-errores`,children:`Gestión de errores`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Estado HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})}),_jsx(_components.th,{children:`Descripción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`invalid_start`}),` / `,_jsx(_components.code,{children:`invalid_end`})]}),_jsx(_components.td,{children:`Formato de inicio o fin no válido`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_range`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`end`}),` no es posterior a `,_jsx(_components.code,{children:`start`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`range_too_large`})}),_jsx(_components.td,{children:`Más de 31 días; divida el período en varias consultas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_tz`})}),_jsx(_components.td,{children:`Zona horaria IANA desconocida`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_group_by`})}),_jsx(_components.td,{children:`Agrupación no válida`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_scope`})}),_jsx(_components.td,{children:`Ámbito no válido`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`too_many_models`})}),_jsx(_components.td,{children:`Más de 50 modelos`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401 / 403`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`API Key no válida o caducada, IP no permitida o cuenta desactivada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Más de 60 consultas por clave por minuto o límite global de la API`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`usage_unavailable`})}),_jsx(_components.td,{children:`Datos temporalmente no disponibles; inténtelo más tarde`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`503 usage_unavailable`}),` no devuelve importes. Significa que la consulta no está disponible, no que los gastos sean 0. No convierta respuestas fallidas en importes cero ni sobrescriba un resultado anterior correcto.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`comparación-con-otros-endpoints`,children:`Comparación con otros endpoints`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Función`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/dashboard/billing/usage`})}),_jsx(_components.td,{children:`Solo gastos acumulados; sin filtros por modelo o período`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/logs/export`})}),_jsx(_components.td,{children:`Exportación asíncrona de detalles de llamadas (CSV / XLSX); debe agregarlos usted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/usage`})}),_jsx(_components.td,{children:`Consulta por período y modelo con devolución directa del total y los detalles agrupados`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Para el saldo restante, use `,_jsx(_components.a,{href:`/es/api-reference/account/token-balance`,children:`Consultar saldo del token`}),` o `,_jsx(_components.a,{href:`/es/api-reference/account/user-balance`,children:`Consultar saldo del usuario`}),`.`]})]})}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":{"config":{},"pageMetadata":{"title":"Consultar gastos y uso","description":" - Consultar gastos y estadísticas de llamadas en un período\n- Filtrar por modelo y agrupar por modelo o día natural\n- Consultar la API Key actual o toda la cuenta\n- Obtener importes en USD, créditos, llamadas y tokens ","api":"GET https://api.apimart.ai/v1/usage","href":"/es/api-reference/account/usage"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Info,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Utilice una API Key para consultar los gastos de un período, con filtros por modelo y agrupación por modelo, día natural o ambos. El resultado agregado se devuelve directamente, sin crear tareas ni consultar su estado periódicamente.`}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`5`,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:`5`,children:[_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:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start=2026-09-01T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end=2026-09-08T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'group_by=model'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`20`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.apimart.ai/v1/usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer \u003ctoken>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01T00:00:00+08:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"end\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-08T00:00:00+08:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"group_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`30`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.ok `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`or`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` payload.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` message `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` payload.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {}).get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Error al consultar el uso\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` raise`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` RuntimeError`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"HTTP `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response.status_code`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`message`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(payload[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(payload[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`20`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.apimart.ai/v1/usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`search`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URLSearchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` start:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"2026-09-01T00:00:00+08:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` end:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"2026-09-08T00:00:00+08:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` group_by:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}).`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`toString`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer \u003ctoken>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` payload`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ||`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` !`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`payload`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`success`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `HTTP \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`payload`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ??`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Error al consultar el uso\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` );`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`payload`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`total`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`payload`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`items`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`35`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`35`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"scope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1788192000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"end\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1788796800`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tz\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Asia/Shanghai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"group_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12.3456`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`123.456`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1834`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`902311`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completion_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`215044`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-5.6-luna\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9.1271`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`91.271`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1520`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`880120`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completion_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`201300`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sora-2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3.2185`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`32.185`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`314`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`22191`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completion_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`13744`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`8`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"range_too_large\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Time range must not exceed 31 days.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"usage_query_error\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`autenticación`,children:`Autenticación`}),`\n`,_jsxs(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:[_jsxs(_components.p,{children:[`Utilice la misma API Key que para llamar a los modelos, con autenticación Bearer Token. Obtenga la clave en la `,_jsx(_components.a,{href:`https://apimart.ai/keys`,children:`página de gestión de API Keys`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer YOUR_API_KEY`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`La consulta funciona incluso con saldo 0. No se comprueba el saldo, pero sí el estado y la caducidad de la clave, la lista de IP permitidas y el estado de la cuenta.`})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /v1/usage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /usage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Ambos endpoints tienen la misma función y admiten CORS. Proteja su API Key y no la exponga en código frontend público.`}),`\n`,_jsx(Heading,{level:`2`,id:`parámetros-de-solicitud`,children:`Parámetros de solicitud`}),`\n`,_jsx(_components.p,{children:`Todos los parámetros se envían en la cadena de consulta de la URL.`}),`\n`,_jsxs(ParamField,{query:`start`,type:`integer | string`,id:`param-start`,children:[_jsxs(_components.p,{children:[`Inicio del período, incluido. Admite un timestamp Unix en segundos o una cadena RFC3339 con zona horaria, como `,_jsx(_components.code,{children:`2026-09-01T00:00:00+08:00`}),`.`]}),_jsxs(_components.p,{children:[`Si se omite, se usan 24 horas antes de `,_jsx(_components.code,{children:`end`}),`. Los timestamps están en segundos, no milisegundos.`]})]}),`\n`,_jsxs(ParamField,{query:`end`,type:`integer | string`,id:`param-end`,children:[_jsxs(_components.p,{children:[`Fin del período, excluido. Mismo formato que `,_jsx(_components.code,{children:`start`}),`; si se omite, se usa la hora actual.`]}),_jsxs(_components.p,{children:[`Debe ser posterior a `,_jsx(_components.code,{children:`start`}),`, y `,_jsx(_components.code,{children:`end - start`}),` no puede superar 31 días.`]})]}),`\n`,_jsxs(ParamField,{query:`model`,type:`string`,id:`param-model`,children:[_jsxs(_components.p,{children:[`Nombre del modelo. Si se omite, se incluyen todos los modelos. Separe varios modelos con comas; máximo `,_jsx(_components.code,{children:`50`}),`.`]}),_jsx(_components.p,{children:`Coincidencia exacta sin distinguir mayúsculas y minúsculas. No admite comodines.`}),_jsxs(_components.p,{children:[`Ejemplo: `,_jsx(_components.code,{children:`gpt-5.6-luna,sora-2`})]})]}),`\n`,_jsxs(ParamField,{query:`group_by`,type:`string`,default:`none`,id:`param-group-by`,children:[_jsx(_components.p,{children:`Agrupación:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`none`}),`: solo el total; `,_jsx(_components.code,{children:`items`}),` es un array vacío`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`model`}),`: por modelo`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`date`}),`: por día natural`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`model,date`}),`: por modelo y día natural`]}),`\n`]})]}),`\n`,_jsxs(ParamField,{query:`tz`,type:`string`,default:`Asia/Shanghai`,id:`param-tz`,children:[_jsxs(_components.p,{children:[`Nombre de zona horaria IANA. Predeterminado: `,_jsx(_components.code,{children:`Asia/Shanghai`}),`.`]}),_jsxs(_components.p,{children:[`Solo afecta a los límites de los días cuando `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`date`}),`; no cambia los instantes de inicio y fin. Las horas RFC3339 se interpretan según su propia zona horaria.`]})]}),`\n`,_jsxs(ParamField,{query:`scope`,type:`string`,default:`key`,id:`param-scope`,children:[_jsx(_components.p,{children:`Ámbito de las estadísticas:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`key`}),`: solo la API Key actual (predeterminado)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`account`}),`: todas las API Keys de la cuenta a la que pertenece la clave actual`]}),`\n`]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`El intervalo es `,_jsx(_components.code,{children:`[start, end)`}),`: incluye el inicio y excluye el final. Use el mismo instante para el `,_jsx(_components.code,{children:`end`}),` de la consulta anterior y el `,_jsx(_components.code,{children:`start`}),` de la siguiente para evitar duplicar el límite.`]}),_jsxs(_components.p,{children:[`Al construir la URL manualmente, codifique el `,_jsx(_components.code,{children:`+`}),` de RFC3339 como `,_jsx(_components.code,{children:`%2B`}),`. cURL `,_jsx(_components.code,{children:`--data-urlencode`}),`, Python `,_jsx(_components.code,{children:`params`}),` y JavaScript `,_jsx(_components.code,{children:`URLSearchParams`}),` en los ejemplos lo hacen automáticamente.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplos-de-solicitud`,children:`Ejemplos de solicitud`}),`\n`,_jsx(Heading,{level:`3`,id:`gastos-de-la-api-key-actual-en-las-últimas-24-horas`,children:`Gastos de la API Key actual en las últimas 24 horas`}),`\n`,_jsx(_components.p,{children:`Sin parámetros de consulta se utilizan el período, ámbito y agrupación predeterminados.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`gastos-diarios-de-toda-la-cuenta-para-modelos-concretos`,children:`Gastos diarios de toda la cuenta para modelos concretos`}),`\n`,_jsx(_components.p,{children:`Consultar los gastos del 11 al 18 de septiembre de 2026, hora de Pekín, sin incluir el 18 de septiembre.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_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:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start=1789056000'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end=1789660800'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'model=gpt-5.6-luna'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'group_by=date'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'scope=account'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'tz=Asia/Shanghai'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`agrupar-por-modelo-y-día-natural`,children:`Agrupar por modelo y día natural`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_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:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.apimart.ai/v1/usage'`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer \u003ctoken>'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start=2026-09-01T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end=2026-09-08T00:00:00+08:00'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'model=gpt-5.6-luna,sora-2'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'group_by=model,date'`}),_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:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'tz=Asia/Shanghai'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Cada elemento de `,_jsx(_components.code,{children:`items`}),` contiene tanto `,_jsx(_components.code,{children:`model`}),` como `,_jsx(_components.code,{children:`date`}),` con esta agrupación.`]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-de-respuesta`,children:`Campos de respuesta`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsxs(_components.p,{children:[`Resultado de la consulta: `,_jsx(_components.code,{children:`true`}),` si tiene éxito, `,_jsx(_components.code,{children:`false`}),` si hay un error al consultar el uso.`]})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:[_jsx(_components.p,{children:`Si tiene éxito, devuelve el ámbito, el total y los detalles agrupados.`}),_jsxs(Expandable,{title:`Propiedades de data`,children:[_jsx(ResponseField,{name:`scope`,type:`string`,id:`param-scope-1`,children:_jsxs(_components.p,{children:[`Ámbito: `,_jsx(_components.code,{children:`key`}),` o `,_jsx(_components.code,{children:`account`}),`.`]})}),_jsx(ResponseField,{name:`start`,type:`integer`,id:`param-start-1`,children:_jsx(_components.p,{children:`Inicio efectivo como timestamp Unix en segundos, incluido.`})}),_jsx(ResponseField,{name:`end`,type:`integer`,id:`param-end-1`,children:_jsx(_components.p,{children:`Fin efectivo como timestamp Unix en segundos, excluido.`})}),_jsx(ResponseField,{name:`tz`,type:`string`,id:`param-tz-1`,children:_jsx(_components.p,{children:`Zona horaria para la agrupación por día natural.`})}),_jsx(ResponseField,{name:`group_by`,type:`string`,id:`param-group-by-1`,children:_jsxs(_components.p,{children:[`Agrupación: `,_jsx(_components.code,{children:`none`}),`, `,_jsx(_components.code,{children:`model`}),`, `,_jsx(_components.code,{children:`date`}),` o `,_jsx(_components.code,{children:`model,date`}),`.`]})}),_jsx(ResponseField,{name:`total`,type:`object`,id:`param-total`,children:_jsx(_components.p,{children:`Total del intervalo consultado. Consulte los campos estadísticos en la tabla siguiente.`})}),_jsxs(ResponseField,{name:`items`,type:`object[]`,id:`param-items`,children:[_jsxs(_components.p,{children:[`Detalles agrupados en orden descendente de `,_jsx(_components.code,{children:`amount_usd`}),`. Array vacío si `,_jsx(_components.code,{children:`group_by=none`}),`. Cada elemento contiene los campos estadísticos de la tabla siguiente.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Si `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`model`}),`, el elemento contiene `,_jsx(_components.code,{children:`model`})]}),`\n`,_jsxs(_components.li,{children:[`Si `,_jsx(_components.code,{children:`group_by`}),` incluye `,_jsx(_components.code,{children:`date`}),`, el elemento contiene `,_jsx(_components.code,{children:`date`}),` en formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`; los días se delimitan según `,_jsx(_components.code,{children:`tz`})]}),`\n`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`data.total`}),` y `,_jsx(_components.code,{children:`data.items[]`}),` comparten estos campos estadísticos:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descripción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount_usd`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Importe en USD, redondeado a 6 decimales`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`credits`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Créditos del servicio: `,_jsx(_components.code,{children:`amount_usd × 10`}),`, la misma unidad que en el sitio web`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requests`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Número de llamadas facturadas correctamente`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt_tokens`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Tokens de entrada; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completion_tokens`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Tokens de salida; normalmente 0 para modelos de imagen y vídeo facturados por llamada o segundo`})]})]})]}),`\n`,_jsx(ResponseField,{name:`error`,type:`object`,id:`param-error`,children:_jsxs(_components.p,{children:[`En errores de consulta de uso, contiene `,_jsx(_components.code,{children:`code`}),`, `,_jsx(_components.code,{children:`message`}),` y `,_jsx(_components.code,{children:`type`}),`, donde `,_jsx(_components.code,{children:`type`}),` es `,_jsx(_components.code,{children:`usage_query_error`}),`. Los errores de autenticación 401 / 403 los devuelve la capa de autenticación.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`límites-y-caché`,children:`Límites y caché`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Máximo `,_jsx(_components.code,{children:`60`}),` consultas por minuto por API Key; también se aplican los límites globales de la API`]}),`\n`,_jsxs(_components.li,{children:[`Los resultados con los mismos parámetros se almacenan en caché durante `,_jsx(_components.code,{children:`60`}),` segundos; la cabecera `,_jsx(_components.code,{children:`X-Usage-Cache`}),` es `,_jsx(_components.code,{children:`hit`}),` o `,_jsx(_components.code,{children:`miss`})]}),`\n`,_jsx(_components.li,{children:`Los gastos suelen estar disponibles en 1 segundo, pero el último minuto puede estar incompleto y la caché puede añadir retrasos`}),`\n`,_jsx(_components.li,{children:`Se recomienda un intervalo mínimo de 1 minuto; no usar como notificación de cobro en tiempo real`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`criterios-de-contabilización`,children:`Criterios de contabilización`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Basado en llamadas facturadas correctamente, con los mismos datos que el panel del sitio web`}),`\n`,_jsx(_components.li,{children:`Se excluyen llamadas fallidas y tareas reembolsadas tras un fallo; no es necesario compensarlas manualmente. Los lotes de imágenes parcialmente completados se cobran según las imágenes realmente entregadas`}),`\n`,_jsx(_components.li,{children:`Se usa el momento de contabilización del cobro. Las tareas asíncronas de imagen y vídeo se contabilizan al finalizar, no al enviarse; las que cruzan la medianoche pertenecen al día de finalización`}),`\n`,_jsxs(_components.li,{children:[`Una API Key recreada tras eliminarla es una clave nueva. Su consulta `,_jsx(_components.code,{children:`scope=key`}),` no incluye el historial de la anterior`]}),`\n`,_jsx(_components.li,{children:`Los ajustes manuales de saldo no son gastos de llamadas y se excluyen`}),`\n`,_jsx(_components.li,{children:`Están disponibles los datos posteriores al 27 de abril de 2026`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`gestión-de-errores`,children:`Gestión de errores`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Estado HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})}),_jsx(_components.th,{children:`Descripción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`invalid_start`}),` / `,_jsx(_components.code,{children:`invalid_end`})]}),_jsx(_components.td,{children:`Formato de inicio o fin no válido`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_range`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`end`}),` no es posterior a `,_jsx(_components.code,{children:`start`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`range_too_large`})}),_jsx(_components.td,{children:`Más de 31 días; divida el período en varias consultas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_tz`})}),_jsx(_components.td,{children:`Zona horaria IANA desconocida`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_group_by`})}),_jsx(_components.td,{children:`Agrupación no válida`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_scope`})}),_jsx(_components.td,{children:`Ámbito no válido`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`too_many_models`})}),_jsx(_components.td,{children:`Más de 50 modelos`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401 / 403`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`API Key no válida o caducada, IP no permitida o cuenta desactivada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Más de 60 consultas por clave por minuto o límite global de la API`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`usage_unavailable`})}),_jsx(_components.td,{children:`Datos temporalmente no disponibles; inténtelo más tarde`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`503 usage_unavailable`}),` no devuelve importes. Significa que la consulta no está disponible, no que los gastos sean 0. No convierta respuestas fallidas en importes cero ni sobrescriba un resultado anterior correcto.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`comparación-con-otros-endpoints`,children:`Comparación con otros endpoints`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Función`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/dashboard/billing/usage`})}),_jsx(_components.td,{children:`Solo gastos acumulados; sin filtros por modelo o período`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/logs/export`})}),_jsx(_components.td,{children:`Exportación asíncrona de detalles de llamadas (CSV / XLSX); debe agregarlos usted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/usage`})}),_jsx(_components.td,{children:`Consulta por período y modelo con devolución directa del total y los detalles agrupados`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Para el saldo restante, use `,_jsx(_components.a,{href:`/es/api-reference/account/token-balance`,children:`Consultar saldo del token`}),` o `,_jsx(_components.a,{href:`/es/api-reference/account/user-balance`,children:`Consultar saldo del usuario`}),`.`]})]})}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":{"config":{},"pageMetadata":{"title":"Consultar gastos y uso","description":" - Consultar gastos y estadísticas de llamadas en un período\n- Filtrar por modelo y agrupar por modelo o día natural\n- Consultar la API Key actual o toda la cuenta\n- Obtener importes en USD, créditos, llamadas y tokens ","api":"GET https://api.apimart.ai/v1/usage","href":"/es/api-reference/account/usage"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Autenticación","slug":"autenticación","depth":2,"children":[]},{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]},{"title":"Parámetros de solicitud","slug":"parámetros-de-solicitud","depth":2,"children":[]},{"title":"Ejemplos de solicitud","slug":"ejemplos-de-solicitud","depth":2,"children":[{"title":"Gastos de la API Key actual en las últimas 24 horas","slug":"gastos-de-la-api-key-actual-en-las-últimas-24-horas","depth":3,"children":[]},{"title":"Gastos diarios de toda la cuenta para modelos concretos","slug":"gastos-diarios-de-toda-la-cuenta-para-modelos-concretos","depth":3,"children":[]},{"title":"Agrupar por modelo y día natural","slug":"agrupar-por-modelo-y-día-natural","depth":3,"children":[]}]},{"title":"Campos de respuesta","slug":"campos-de-respuesta","depth":2,"children":[]},{"title":"Límites y caché","slug":"límites-y-caché","depth":2,"children":[]},{"title":"Criterios de contabilización","slug":"criterios-de-contabilización","depth":2,"children":[]},{"title":"Gestión de errores","slug":"gestión-de-errores","depth":2,"children":[]},{"title":"Comparación con otros endpoints","slug":"comparación-con-otros-endpoints","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --get\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.apimart.ai/v1/usage'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Authorization: Bearer \u0026#x3C;token>'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'start=2026-09-01T00:00:00+08:00'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'end=2026-09-08T00:00:00+08:00'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data-urlencode\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'group_by=model'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"20\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.apimart.ai/v1/usage\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authorization\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Bearer \u0026#x3C;token>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"start\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-01T00:00:00+08:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"end\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-08T00:00:00+08:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"group_by\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> timeout\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">30\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> not\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.ok \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">or\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> not\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> payload.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">):\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> message \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> payload.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {}).get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Error al consultar el uso\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> raise\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4EC9B0\"> RuntimeError\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"HTTP \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response.status_code\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">message\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(payload[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">])\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(payload[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"items\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">])\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"20\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> url\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> URL\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.apimart.ai/v1/usage\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">url\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">search\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> URLSearchParams\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> start:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"2026-09-01T00:00:00+08:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> end:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"2026-09-08T00:00:00+08:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> group_by:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}).\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">toString\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">url\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Bearer \u0026#x3C;token>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> payload\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">!\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">ok\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> ||\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> !\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">payload\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">success\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> throw\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> Error\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `HTTP \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">status\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">payload\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">error\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">?.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">message\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> ??\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Error al consultar el uso\"\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> );\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">payload\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">total\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">payload\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">items\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"35\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"scope\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"start\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1788192000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"end\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1788796800\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Asia/Shanghai\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"group_by\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_usd\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12.3456\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">123.456\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"requests\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1834\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"prompt_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">902311\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"completion_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">215044\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"items\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"gpt-5.6-luna\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_usd\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">9.1271\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">91.271\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"requests\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1520\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"prompt_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">880120\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"completion_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">201300\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sora-2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_usd\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3.2185\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">32.185\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"requests\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">314\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"prompt_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">22191\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"completion_tokens\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">13744\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"range_too_large\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Time range must not exceed 31 days.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"usage_query_error\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Consultar gastos y uso","path":"/v1/usage","servers":[{"url":"https://api.apimart.ai"}],"method":"get","request":{"security":[],"parameters":{"query":{"start":{"schema":[{"type":"object","properties":{},"description":"Inicio del período, incluido. Admite un timestamp Unix en segundos o una cadena RFC3339 con zona horaria, como `2026-09-01T00:00:00+08:00` . Si se omite, se usan 24 horas antes de `end` . Los timestamps están en segundos, no milisegundos."}]},"end":{"schema":[{"type":"object","properties":{},"description":"Fin del período, excluido. Mismo formato que `start` ; si se omite, se usa la hora actual. Debe ser posterior a `start` , y `end - start` no puede superar 31 días."}]},"model":{"schema":[{"type":"string","description":"Nombre del modelo. Si se omite, se incluyen todos los modelos. Separe varios modelos con comas; máximo `50` . Coincidencia exacta sin distinguir mayúsculas y minúsculas. No admite comodines. Ejemplo: `gpt-5.6-luna,sora-2`"}]},"group_by":{"schema":[{"type":"string","description":"Agrupación: `none` : solo el total; `items` es un array vacío `model` : por modelo `date` : por día natural `model,date` : por modelo y día natural"}]},"tz":{"schema":[{"type":"string","description":"Nombre de zona horaria IANA. Predeterminado: `Asia/Shanghai` . Solo afecta a los límites de los días cuando `group_by` incluye `date` ; no cambia los instantes de inicio y fin. Las horas RFC3339 se interpretan según su propia zona horaria."}]},"scope":{"schema":[{"type":"string","description":"Ámbito de las estadísticas: `key` : solo la API Key actual (predeterminado) `account` : todas las API Keys de la cuenta a la que pertenece la clave actual"}]}},"header":{"Authorization":{"schema":[{"type":"string","description":"Utilice la misma API Key que para llamar a los modelos, con autenticación Bearer Token. Obtenga la clave en la página de gestión de API Keys .","required":true}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"success":[{"type":"boolean","description":"Resultado de la consulta: `true` si tiene éxito, `false` si hay un error al consultar el uso."}],"data":[{"type":"object","properties":{"scope":[{"type":"string","description":"Ámbito: `key` o `account` ."}],"start":[{"type":"integer","description":"Inicio efectivo como timestamp Unix en segundos, incluido."}],"end":[{"type":"integer","description":"Fin efectivo como timestamp Unix en segundos, excluido."}],"tz":[{"type":"string","description":"Zona horaria para la agrupación por día natural."}],"group_by":[{"type":"string","description":"Agrupación: `none` , `model` , `date` o `model,date` ."}],"total":[{"type":"object","properties":{},"description":"Total del intervalo consultado. Consulte los campos estadísticos en la tabla siguiente."}],"items":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Detalles agrupados en orden descendente de `amount_usd` . Array vacío si `group_by=none` . Cada elemento contiene los campos estadísticos de la tabla siguiente. Si `group_by` incluye `model` , el elemento contiene `model` Si `group_by` incluye `date` , el elemento contiene `date` en formato `YYYY-MM-DD` ; los días se delimitan según `tz`"}]},"description":"Si tiene éxito, devuelve el ámbito, el total y los detalles agrupados."}],"error":[{"type":"object","properties":{},"description":"En errores de consulta de uso, contiene `code` , `message` y `type` , donde `type` es `usage_query_error` . Los errores de autenticación 401 / 403 los devuelve la capa de autenticación."}]}}],"examples":{"example":{"value":{"success":true,"data":{"scope":"\u003cstring>","start":123,"end":123,"tz":"\u003cstring>","group_by":"\u003cstring>","total":{},"items":[{}]},"error":{}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/apicore/1f7e29c94a916812/cn-domain-rewrite.js","/_mintlify/custom/apicore/afc6076845564106/param-field-copy.js"],"subdomain":"apicore","siteName":"APIMart","title":"Consultar gastos y uso - APIMart","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/account/usage","matchLevel":1},"zh-Hans":{"href":"/cn/api-reference/account/usage","matchLevel":1},"ja":{"href":"/ja/api-reference/account/usage","matchLevel":1},"ko":{"href":"/ko/api-reference/account/usage","matchLevel":1},"ru":{"href":"/ru/api-reference/account/usage","matchLevel":1},"de":{"href":"/de/api-reference/account/usage","matchLevel":1},"fr":{"href":"/fr/api-reference/account/usage","matchLevel":1},"pt":{"href":"/pt/api-reference/account/usage","matchLevel":1},"id":{"href":"/id/api-reference/account/usage","matchLevel":1},"es":{"href":"/es/api-reference/account/usage","matchLevel":0}}},"lastModified":"2026-09-18T09:08:07.837Z","originalFileLocation":"es/api-reference/account/usage.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"- Consultar gastos y estadísticas de llamadas en un período - Filtrar por modelo y agrupar por modelo o día natural - Consultar la API Key actual o toda la cuenta - Obtener importes en USD, créditos, llamadas y tokens\">\u003cmeta data-mint-head name=\"keywords\" content=\"OpenAI compatible, API gateway, GPT-5, Claude, Gemini, multi-provider, transparent pricing, SLA\">\u003cmeta data-mint-head name=\"application-name\" content=\"APIMart\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Consultar gastos y uso - APIMart\">\u003cmeta data-mint-head property=\"og:description\" content=\"- Consultar gastos y estadísticas de llamadas en un período - Filtrar por modelo y agrupar por modelo o día natural - Consultar la API Key actual o toda la cuenta - Obtener importes en USD, créditos, llamadas y tokens\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"APIMart\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apimart.ai/es/api-reference/account/usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apicore.mintlify.app/_mintlify/api/og/v2?division=Gesti%C3%B3n+de+cuenta\u0026amp;title=Consultar+gastos+y+uso\u0026amp;description=+-+Consultar+gastos+y+estad%C3%ADsticas+de+llamadas+en+un+per%C3%ADodo%0A-+Filtrar+por+modelo+y+agrupar+por+modelo+o+d%C3%ADa+natural%0A-+Consultar+la+API+Key+actual+o+toda+la+cue\u0026amp;theme=85f832f8b30837d0268a5e67\u0026amp;signature=f01be2ddf34a77557e052df522681a6e4c6a2ebdb5d1c3ef54a48fe18c9518c0\">\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=\"Consultar gastos y uso - APIMart\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"- Consultar gastos y estadísticas de llamadas en un período - Filtrar por modelo y agrupar por modelo o día natural - Consultar la API Key actual o toda la cuenta - Obtener importes en USD, créditos, llamadas y tokens\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apicore.mintlify.app/_mintlify/api/og/v2?division=Gesti%C3%B3n+de+cuenta\u0026amp;title=Consultar+gastos+y+uso\u0026amp;description=+-+Consultar+gastos+y+estad%C3%ADsticas+de+llamadas+en+un+per%C3%ADodo%0A-+Filtrar+por+modelo+y+agrupar+por+modelo+o+d%C3%ADa+natural%0A-+Consultar+la+API+Key+actual+o+toda+la+cue\u0026amp;theme=85f832f8b30837d0268a5e67\u0026amp;signature=f01be2ddf34a77557e052df522681a6e4c6a2ebdb5d1c3ef54a48fe18c9518c0\">\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/apicore/lN2mX6cSovqJeXFa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"APIMart\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@APIMart_\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apimart.ai/es/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/account/usage.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.apimart.ai/es/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apimart.ai/en/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hans\" href=\"https://docs.apimart.ai/cn/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apimart.ai/ja/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apimart.ai/ko/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apimart.ai/ru/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.apimart.ai/de/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.apimart.ai/fr/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.apimart.ai/pt/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.apimart.ai/id/api-reference/account/usage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apimart.ai/en/api-reference/account/usage\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apimart.ai/#organization\",\"name\":\"APIMart\",\"url\":\"https://docs.apimart.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apimart.ai#website\",\"name\":\"APIMart\",\"url\":\"https://docs.apimart.ai\",\"publisher\":{\"@id\":\"https://docs.apimart.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apimart.ai/es/api-reference/account/usage#webpage\",\"url\":\"https://docs.apimart.ai/es/api-reference/account/usage\",\"name\":\"Consultar gastos y uso\",\"description\":\"- Consultar gastos y estadísticas de llamadas en un período - Filtrar por modelo y agrupar por modelo o día natural - Consultar la API Key actual o toda la cuenta - Obtener importes en USD, créditos, llamadas y tokens\",\"dateModified\":\"2026-09-18T09:08:07.837Z\",\"isPartOf\":{\"@id\":\"https://docs.apimart.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apimart.ai/es/api-reference/account/usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apimart.ai/es/api-reference/account/usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gestión de cuenta\",\"item\":\"https://docs.apimart.ai/es/api-reference/account/token-balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Consultar gastos y uso\",\"item\":\"https://docs.apimart.ai/es/api-reference/account/usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apimart.ai/es/api-reference/account/usage#apireference\",\"headline\":\"Consultar gastos y uso\",\"name\":\"Consultar gastos y uso\",\"description\":\"- Consultar gastos y estadísticas de llamadas en un período - Filtrar por modelo y agrupar por modelo o día natural - Consultar la API Key actual o toda la cuenta - Obtener importes en USD, créditos, llamadas y tokens\",\"url\":\"https://docs.apimart.ai/es/api-reference/account/usage\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apimart.ai/es/api-reference/account/usage#webpage\"},\"dateModified\":\"2026-09-18T09:08:07.837Z\",\"publisher\":{\"@id\":\"https://docs.apimart.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apimart.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"APIMart\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"APIMart","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/en/api-reference/account/usage"}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/cn/api-reference/account/usage"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/api-reference/account/usage"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/account/usage"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/api-reference/account/usage"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/account/usage"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/account/usage"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/api-reference/account/usage"}]},{"language":"id","pages":[{"title":"id","href":"/id/api-reference/account/usage"}]},{"language":"es","tabs":[{"tab":"Manual de la API","groups":[{"group":"Visión general","pages":[{"title":"APIMart — Gateway de API compatible con OpenAI (GPT-5, Claude, Gemini)","href":"/es"}]},{"group":"Modelos","pages":[{"title":"API de metadatos de la lista de modelos","api":"GET https://api.apimart.ai/v1/models","href":"/es/api-reference/texts/models/list"}]},{"group":"Serie de texto","icon":"text","pages":[{"title":"API general de Chat (streaming por defecto)","api":"POST https://api.apimart.ai/v1/chat/completions","href":"/es/api-reference/texts/general/chat-completions"},{"title":"API general de Chat (sin streaming por defecto)","api":"POST https://api.apimart.ai/api/v1/chat/completions","href":"/es/api-reference/texts/general/chat-completions-nostream"},{"title":"API de Mensajes Claude","api":"POST https://api.apimart.ai/v1/messages","href":"/es/api-reference/texts/general/claude-messages"},{"title":"Formato nativo de Gemini","api":"POST https://api.apimart.ai/v1beta/models/{model}:{method}","href":"/es/api-reference/texts/gemini/quickstart"},{"title":"API multimodal OpenAI Responses","api":"POST https://api.apimart.ai/v1/responses","href":"/es/api-reference/texts/openai/responses"},{"title":"Guía de uso de la caché de contexto de Gemini","sidebarTitle":"Caché de contexto de Gemini","icon":"database","href":"/es/api-reference/texts/gemini/context-cache"},{"title":"Guía de uso de la caché de contexto de Claude","sidebarTitle":"Caché de contexto de Claude","icon":"database","href":"/es/api-reference/texts/general/claude-context-cache"},{"group":"qwen3.8-max","icon":"message","pages":[{"title":"qwen3.8-max Integration Guide","api":"POST https://api.apimart.ai/v1/chat/completions","href":"/es/api-reference/texts/qwen3.8-max/guide"},{"title":"Model Pricing API","api":"GET https://api.apimart.ai/api/pricing/model?model=qwen3.8-max","href":"/es/api-reference/texts/qwen3.8-max/pricing"}]}]},{"group":"Serie de imágenes","icon":"image","pages":[{"group":"Nano banana 2.1","icon":"image","pages":[{"title":"Nano banana 2.1 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-nano-banana-2.1/generation"}]},{"group":"Nano banana2","icon":"image","pages":[{"title":"Nano banana2 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3.1-flash/generation"},{"title":"Nano Banana Lite Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3.1-flash/generation-lite"}]},{"group":"Nano banana Pro","icon":"image","pages":[{"title":"Nano banana Pro Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3-pro/generation"}]},{"group":"Nano banana","icon":"image","pages":[{"title":"Nano banana Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-2.5-flash/generation"}]},{"group":"Imagen-4.0","icon":"image","pages":[{"title":"Generación de imágenes con Imagen 4.0 Apimart","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/imagen-4.0-apimart/generation"}]},{"group":"GPT-Image(1/1.5)","icon":"image","pages":[{"title":"Generación de imágenes con GPT-Image(1/1.5)","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-1/generation"}]},{"group":"GPT-Image-2","icon":"image","pages":[{"title":"Generación de imágenes con GPT-Image-2","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2/generation"},{"title":"Generación de imágenes con GPT-Image-2 canal oficial","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2/official"}]},{"group":"GPT-Image-2.5","icon":"image","pages":[{"title":"Generación de imágenes GPT-Image-2.5","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.5/generation"}]},{"group":"GPT-Image-2.5 Ext","icon":"image","pages":[{"title":"GPT-Image-2.5 Ext — Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.5-ext/generation"}]},{"group":"Seedream-4.0","icon":"image","pages":[{"title":"Generación de imágenes Seedream-4.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-4/generation"}]},{"group":"Seedream-4.5","icon":"image","pages":[{"title":"Generación de imágenes Seedream-4.5","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-4.5/generation"}]},{"group":"Seedream-5.0-Lite","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Lite","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-lite/generation"}]},{"group":"Seedream-5.0-Pro","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Pro","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-0-pro/generation"}]},{"group":"Seedream-5.0-Flash","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Flash","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-0-flash/generation"}]},{"group":"Flux Kontext","icon":"image","pages":[{"title":"Generación y edición de imágenes con FLUX Kontext","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-kontext/generation"}]},{"group":"Flux 2.0","icon":"image","pages":[{"title":"Generación de imágenes con FLUX.2","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-2/generation"}]},{"group":"FLUX 3 Image","icon":"image","pages":[{"title":"FLUX 3 Image Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-3-image/generation"}]},{"group":"FLUX 3 Image Klein","icon":"image","pages":[{"title":"FLUX 3 Image Klein Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-3-image-klein/generation"}]},{"group":"Hy-Image-3.5 Preview","icon":"image","pages":[{"title":"Hy-Image-3.5 Preview Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/hy-image-v3.5-preview/generation"}]},{"group":"MAI-Image-2.6","icon":"image","pages":[{"title":"MAI-Image-2.6 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/mai-image-2.6/generation"}]},{"group":"Qwen Image 2.0","icon":"image","pages":[{"title":"Generación de imágenes Qwen Image 2.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/qwen-image/generation"}]},{"group":"Qwen Image 3.0","icon":"image","pages":[{"title":"Generación de imágenes Qwen Image 3.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/qwen-image-3.0/generation"}]},{"group":"Z-Image-Turbo","icon":"image","pages":[{"title":"Generación de imágenes Z-Image-Turbo","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/z-image-turbo/generation"}]},{"group":"Grok Imagine","icon":"image","pages":[{"title":"Grok Imagine generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine/generation"}]},{"group":"Grok Imagine 2.0 Ext","icon":"image","pages":[{"title":"Grok Imagine 2.0 Ext generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/generation"},{"title":"Capas y edición de regiones de Grok Imagine 2.0 Ext","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/layer-region-edit"},{"title":"Grok Imagine Image 2.0 — generación y edición oficiales","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/official"}]},{"group":"wan2.7-image","icon":"image","pages":[{"title":"Generación y edición de imágenes wan2.7","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/wan2.7-image/generation"}]},{"group":"Midjourney","icon":"image","pages":[{"title":"API de Midjourney","href":"/es/api-reference/images/midjourney/generation"},{"title":"Imagine (texto a imagen)","api":"POST https://api.apimart.ai/v1/midjourney/generations","href":"/es/api-reference/images/midjourney/imagine"},{"title":"Blend (mezcla de varias imágenes)","api":"POST https://api.apimart.ai/v1/midjourney/generations/blend","href":"/es/api-reference/images/midjourney/blend"},{"title":"Describe (imagen a texto)","api":"POST https://api.apimart.ai/v1/midjourney/generations/describe","href":"/es/api-reference/images/midjourney/describe"},{"title":"Edits (edición de imagen)","api":"POST https://api.apimart.ai/v1/midjourney/generations/edits","href":"/es/api-reference/images/midjourney/edits"},{"title":"Upscale (ampliar una baldosa)","api":"POST https://api.apimart.ai/v1/midjourney/generations/upscale","href":"/es/api-reference/images/midjourney/upscale"},{"title":"Variation (variación)","api":"POST https://api.apimart.ai/v1/midjourney/generations/variation","href":"/es/api-reference/images/midjourney/variation"},{"title":"High Variation (variación fuerte)","api":"POST https://api.apimart.ai/v1/midjourney/generations/high-variation","href":"/es/api-reference/images/midjourney/high-variation"},{"title":"Low Variation (variación sutil)","api":"POST https://api.apimart.ai/v1/midjourney/generations/low-variation","href":"/es/api-reference/images/midjourney/low-variation"},{"title":"Reroll (regenerar)","api":"POST https://api.apimart.ai/v1/midjourney/generations/reroll","href":"/es/api-reference/images/midjourney/reroll"},{"title":"Zoom (zoom out)","api":"POST https://api.apimart.ai/v1/midjourney/generations/zoom","href":"/es/api-reference/images/midjourney/zoom"},{"title":"Pan (paneo)","api":"POST https://api.apimart.ai/v1/midjourney/generations/pan","href":"/es/api-reference/images/midjourney/pan"},{"title":"Inpaint (Vary Region)","api":"POST https://api.apimart.ai/v1/midjourney/generations/inpaint","href":"/es/api-reference/images/midjourney/inpaint"},{"title":"Modal (enviar parámetros)","api":"POST https://api.apimart.ai/v1/midjourney/generations/modal","href":"/es/api-reference/images/midjourney/modal"},{"title":"Video (imagen a video)","api":"POST https://api.apimart.ai/v1/midjourney/generations/video","href":"/es/api-reference/images/midjourney/video"},{"title":"Remix (reshape, solo v8.1 / v8.2)","api":"POST https://api.apimart.ai/v1/midjourney/generations/remix-strong","href":"/es/api-reference/images/midjourney/remix"},{"title":"Consultar tarea","api":"GET https://api.apimart.ai/v1/midjourney/{task_id}","href":"/es/api-reference/images/midjourney/query"},{"title":"Buenas prácticas","href":"/es/api-reference/images/midjourney/best-practices"},{"title":"Ejemplo de flujo de trabajo completo","href":"/es/api-reference/images/midjourney/workflow"}]}]},{"group":"Serie de video","icon":"video","pages":[{"group":"seedance-1-0-pro","icon":"video","pages":[{"title":"Generación de video seedance-1-0-pro","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/doubao/generation"}]},{"group":"seedance-1-5-pro","icon":"video","pages":[{"title":"Generación de video seedance-1-5-pro","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-1-5-pro/generation"}]},{"group":"seedance-2-0","icon":"video","pages":[{"title":"Generación de video seedance-2.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-2-0/generation"},{"title":"Assets de avatar virtual","api":"POST https://api.apimart.ai/v1/seedance2/private-avatar","href":"/es/api-reference/videos/seedance-2-0/private-avatar"}]},{"group":"seedance-2-5","icon":"video","pages":[{"title":"seedance-2.5 Video Generation","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-2-5/generation"}]},{"group":"VEO3","icon":"video","pages":[{"title":"Generación de video VEO3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/veo3/generation"},{"title":"Remix de video VEO3","api":"POST https://api.apimart.ai/v1/videos/{task_id}/remix","href":"/es/api-reference/videos/veo3/remix"},{"title":"Generación de video VEO3 Oficial","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/veo3/generation-official"}]},{"group":"MiniMax-Hailuo-02","icon":"video","pages":[{"title":"Generación de video MiniMax-Hailuo-02","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-hailuo/generation"}]},{"group":"MiniMax-Hailuo-2.3","icon":"video","pages":[{"title":"Generación de Video MiniMax-Hailuo-2.3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-hailuo-2.3/generation"}]},{"group":"MiniMax-H3","icon":"video","pages":[{"title":"Generación de Video MiniMax-H3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/generation"},{"title":"Generación de vídeo MiniMax-H3-Max","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/max"},{"title":"MiniMax-H3 Context-IR mejora de prompt","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/context-ir"},{"title":"MiniMax-H3 Regeneration","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/regeneration"}]},{"group":"FLUX 3 Video","icon":"video","pages":[{"title":"Generación de vídeo FLUX 3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/flux-3-video/generation"}]},{"group":"SkyReels V4","icon":"video","pages":[{"title":"Generación de Video SkyReels V4","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/skyreels-v4/generation"}]},{"group":"HappyHorse","icon":"video","pages":[{"title":"Generación de Video HappyHorse 1.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/happyhorse-1.0/generation"},{"title":"Generación de Video HappyHorse 1.1","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/happyhorse-1.1/generation"}]},{"group":"Wan3.0","icon":"video","pages":[{"title":"Generación de vídeo Wan3.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan3.0-video/generation"}]},{"group":"Wan2.7","icon":"video","pages":[{"title":"Generación de Video Wan2.7","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7/generation"},{"title":"Wan2.7-R2V Reference-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7-r2v/generation"},{"title":"Edición de Video Wan2.7-VideoEdit","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7-videoedit/generation"}]},{"group":"Wan2.6","icon":"video","pages":[{"title":"Generación de Video Wan2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.6/generation"},{"title":"wan2.6-i2v-flash Image-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.6/i2v-flash-generation"}]},{"group":"Wan2.5","icon":"video","pages":[{"title":"Generación de Video wan2.5-preview","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.5/generation"}]},{"group":"Kling 2.6","icon":"video","pages":[{"title":"Generación de Video Kling 2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v2-6/generation"},{"title":"Generación de video con control de movimiento Kling v2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v2-6/kling-v2-6-motion-control-generation"}]},{"group":"Kling v3","icon":"video","pages":[{"title":"Generación de video Kling v3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v3/generation"}]},{"group":"Kling 3.0 Turbo","icon":"video","pages":[{"title":"Generación de video Kling 3.0 Turbo","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-3.0-turbo/generation"}]},{"group":"Kling v3 Omni","icon":"video","pages":[{"title":"Generación de video Kling v3 Omni","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v3-omni/generation"}]},{"group":"Kling V4","icon":"video","pages":[{"title":"Kling V4 Generación de vídeos","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v4/generation"}]},{"group":"Kling Video O1","icon":"video","pages":[{"title":"Generación de video Kling Video O1","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-video-o1/generation"}]},{"group":"Vidu Q3(pro/turbo)","icon":"video","pages":[{"title":"Generación de video Vidu Q3 (pro/turbo)","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q3-pro/generation"}]},{"group":"Vidu Q4 Preview","icon":"video","pages":[{"title":"Vidu Q4 Preview Generación de video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q4-preview/generation"}]},{"group":"Vidu Q3(mix/standard)","icon":"video","pages":[{"title":"Vidu Q3 (mix/standard) Reference-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q3/generation"}]},{"group":"Grok Imagine","icon":"video","pages":[{"title":"Generación de video Grok Imagine 1.5","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/grok-imagine/generation"},{"title":"Modelos oficiales de vídeo Grok","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/grok-imagine/official"}]},{"group":"Pixverse v6","icon":"video","pages":[{"title":"Pixverse v6 Generación de Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/pixverse-v6/generation"}]},{"group":"PixVerse V6 Max","icon":"video","pages":[{"title":"PixVerse V6 Max Generación de vídeos","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/pixverse-v6-max/generation"}]},{"group":"gemini-omni-1.1-flash-ext","icon":"video","pages":[{"title":"Generación de video gemini-omni-1.1-flash-ext","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/omni-flash-ext/generation"}]},{"group":"Gemini Omni 1.1 Flash","icon":"video","pages":[{"title":"Generación de video Gemini Omni 1.1 Flash","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-1.1-flash/generation"}]},{"group":"Gemini Omni Flash","icon":"video","pages":[{"title":"Generación de video Gemini Omni Flash","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-flash-preview/generation"}]}]},{"group":"Serie de audio","icon":"microphone","pages":[{"title":"Transcripción de audio Whisper-1","api":"POST https://api.apimart.ai/v1/audio/transcriptions","href":"/es/api-reference/audios/whisper-1"},{"title":"TTS Texto a voz","api":"POST https://api.apimart.ai/v1/audio/speech","href":"/es/api-reference/audios/tts"},{"group":"Flow Music","icon":"music","pages":[{"title":"Generar música","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/flow-music/music"},{"title":"Generar música con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/flow-music/music-lyria-3-5"},{"title":"Generar letras","api":"POST https://api.apimart.ai/v1/music/generations/lyricsFlowMusic","href":"/es/api-reference/audios/flow-music/lyrics"},{"title":"Extensión de música","api":"POST https://api.apimart.ai/v1/music/generations/extendFlowMusic","href":"/es/api-reference/audios/flow-music/extend"},{"title":"Extensión de música con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/extendFlowMusic","href":"/es/api-reference/audios/flow-music/extend-lyria-3-5"},{"title":"Reemplazo de fragmento","api":"POST https://api.apimart.ai/v1/music/generations/replaceFlowMusic","href":"/es/api-reference/audios/flow-music/replace"},{"title":"Reemplazo de fragmento con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/replaceFlowMusic","href":"/es/api-reference/audios/flow-music/replace-lyria-3-5"},{"title":"Adaptación Cover","api":"POST https://api.apimart.ai/v1/music/generations/coverFlowMusic","href":"/es/api-reference/audios/flow-music/cover"},{"title":"Adaptación Cover con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/coverFlowMusic","href":"/es/api-reference/audios/flow-music/cover-lyria-3-5"},{"title":"Separación de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stemsFlowMusic","href":"/es/api-reference/audios/flow-music/stems"},{"title":"Subir audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadAudioFlowMusic","href":"/es/api-reference/audios/flow-music/upload-audio"},{"title":"Descargar audio","api":"POST https://api.apimart.ai/v1/music/generations/downloadAudioFlowMusic","href":"/es/api-reference/audios/flow-music/download-audio"},{"title":"Renderizado de video musical","api":"POST https://api.apimart.ai/v1/music/generations/videoClipFlowMusic","href":"/es/api-reference/audios/flow-music/video-clip"},{"title":"Consultar tarea","api":"GET https://api.apimart.ai/v1/music/tasks/{task_id}","href":"/es/api-reference/audios/flow-music/query"}]},{"group":"Suno","icon":"music","pages":[{"title":"Reglas generales de Suno V6 y consulta de tareas","api":"GET https://api.apimart.ai/v1/music/tasks/{task_id}","href":"/es/api-reference/audios/suno/overview"},{"title":"Generar música","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/suno/generation"},{"title":"Generar letra","api":"POST https://api.apimart.ai/v1/music/generations/lyrics","href":"/es/api-reference/audios/suno/lyrics"},{"title":"Generación por inspiración (inspo)","api":"POST https://api.apimart.ai/v1/music/generations/inspo","href":"/es/api-reference/audios/suno/inspo"},{"title":"Generación de efectos de sonido","api":"POST https://api.apimart.ai/v1/music/generations/sounds","href":"/es/api-reference/audios/suno/sounds"},{"title":"Mejora de etiquetas","api":"POST https://api.apimart.ai/v1/music/generations/upsampleTags","href":"/es/api-reference/audios/suno/upsample-tags"},{"title":"Subir audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadTask","href":"/es/api-reference/audios/suno/upload"},{"title":"Subir audio y crear una versión","api":"POST https://api.apimart.ai/v1/music/generations/uploadCover","href":"/es/api-reference/audios/suno/upload-cover"},{"title":"Subir y extender audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadExtend","href":"/es/api-reference/audios/suno/upload-extend"},{"title":"Crear un modelo personalizado","api":"POST https://api.apimart.ai/v1/music/generations/createModel","href":"/es/api-reference/audios/suno/create-model"},{"title":"Continuación y extensión","api":"POST https://api.apimart.ai/v1/music/generations/extend","href":"/es/api-reference/audios/suno/extend"},{"title":"Versión de estilo","api":"POST https://api.apimart.ai/v1/music/generations/coverSong","href":"/es/api-reference/audios/suno/cover-song"},{"title":"Masterización","api":"POST https://api.apimart.ai/v1/music/generations/remaster","href":"/es/api-reference/audios/suno/remaster"},{"title":"Extracción de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stems","href":"/es/api-reference/audios/suno/stems"},{"title":"Separación total de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stemsAll","href":"/es/api-reference/audios/suno/stems-all"},{"title":"Añadir voz","api":"POST https://api.apimart.ai/v1/music/generations/addVocals","href":"/es/api-reference/audios/suno/add-vocals"},{"title":"Añadir acompañamiento","api":"POST https://api.apimart.ai/v1/music/generations/addInstrumental","href":"/es/api-reference/audios/suno/add-instrumental"},{"title":"Añadir pista (add stem)","api":"POST https://api.apimart.ai/v1/music/generations/addStem","href":"/es/api-reference/audios/suno/add-stem"},{"title":"Extraer Vox (obsoleto)","api":"POST https://api.apimart.ai/v1/music/generations/vox","href":"/es/api-reference/audios/suno/vox"},{"title":"Crear voz","api":"POST https://api.apimart.ai/v1/music/generations/createVoice","href":"/es/api-reference/audios/suno/create-voice"},{"title":"Persona","api":"POST https://api.apimart.ai/v1/music/generations/persona","href":"/es/api-reference/audios/suno/persona"},{"title":"Reemplazo de sección","api":"POST https://api.apimart.ai/v1/music/generations/replaceMusic","href":"/es/api-reference/audios/suno/replace-music"},{"title":"Eliminar fragmento","api":"POST https://api.apimart.ai/v1/music/generations/removeSection","href":"/es/api-reference/audios/suno/remove-section"},{"title":"Recortar audio","api":"POST https://api.apimart.ai/v1/music/generations/crop","href":"/es/api-reference/audios/suno/crop"},{"title":"Fundido de entrada","api":"POST https://api.apimart.ai/v1/music/generations/fadeIn","href":"/es/api-reference/audios/suno/fade-in"},{"title":"Fundido de salida","api":"POST https://api.apimart.ai/v1/music/generations/fadeOut","href":"/es/api-reference/audios/suno/fade-out"},{"title":"Ajustar la velocidad","api":"POST https://api.apimart.ai/v1/music/generations/adjustSpeed","href":"/es/api-reference/audios/suno/adjust-speed"},{"title":"Síntesis / ensamblaje de la canción completa","api":"POST https://api.apimart.ai/v1/music/generations/concat","href":"/es/api-reference/audios/suno/concat"},{"title":"Generar mashup","api":"POST https://api.apimart.ai/v1/music/generations/mashup","href":"/es/api-reference/audios/suno/mashup"},{"title":"Muestra a canción (sample)","api":"POST https://api.apimart.ai/v1/music/generations/sample","href":"/es/api-reference/audios/suno/sample"},{"title":"Generar MIDI","api":"POST https://api.apimart.ai/v1/music/generations/midi","href":"/es/api-reference/audios/suno/midi"},{"title":"Línea de tiempo de la letra","api":"POST https://api.apimart.ai/v1/music/generations/alignedLyrics","href":"/es/api-reference/audios/suno/aligned-lyrics"},{"title":"Análisis de BPM","api":"POST https://api.apimart.ai/v1/music/generations/bpm","href":"/es/api-reference/audios/suno/bpm"},{"title":"Generar vídeo musical (MV)","api":"POST https://api.apimart.ai/v1/music/generations/generateMp4","href":"/es/api-reference/audios/suno/generate-mp4"},{"title":"Descargar archivos de audio","api":"POST https://api.apimart.ai/v1/music/generations/download","href":"/es/api-reference/audios/suno/wav"}]}]},{"group":"Serie de Moderación","icon":"shield-check","pages":[{"group":"omni-moderation-latest","icon":"shield-check","pages":[{"title":"omni-moderation-latest Moderación de contenido","api":"POST https://api.apimart.ai/v1/moderations","href":"/es/api-reference/moderations/omni-moderation-latest/generation"}]}]},{"group":"Gestión de subidas","icon":"cloud-arrow-up","pages":[{"title":"Subir imagen","api":"POST https://api.apimart.ai/v1/uploads/images","href":"/es/api-reference/uploads/images"}]},{"group":"Gestión de tareas","icon":"list-check","pages":[{"title":"Obtener estado de la tarea","api":"GET https://api.apimart.ai/v1/tasks/{task_id}","href":"/es/api-reference/tasks/status"},{"title":"Devolución de llamada al completar la tarea (Webhook)","href":"/es/api-reference/tasks/webhook"}]},{"group":"Gestión de cuenta","icon":"wallet","pages":[{"title":"Consultar saldo del token","api":"GET https://api.apimart.ai/v1/balance","href":"/es/api-reference/account/token-balance"},{"title":"Consultar saldo del usuario","description":" - Consultar el crédito restante y utilizado total de la cuenta del usuario\n- Obtener información del saldo a nivel de usuario\n- Soporte CORS para solicitudes de origen cruzado\n- Monitoreo del saldo en tiempo real ","api":"GET https://api.apimart.ai/v1/user/balance","href":"/es/api-reference/account/user-balance"},{"title":"Consultar gastos y uso","api":"GET https://api.apimart.ai/v1/usage","href":"/es/api-reference/account/usage"}]}]},{"tab":"Integraciones","pages":[{"title":"Integraciones","href":"/es/integrations/chat/chatbox"}]},{"tab":"Guías","pages":[{"title":"Guías","href":"/es/quickstart"}]},{"tab":"Preguntas frecuentes","pages":[{"title":"Preguntas frecuentes","href":"/es/faqs"}]}]}]},"title":"Consultar gastos y uso - APIMart","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js"]}