# MKA1: Spanish Referencia API Usage and budgets ## Usage and budgets ### Usage - [Obtener uso de completaciones](https://docs.mka1.com/api-reference/usage/obtener-uso-de-completaciones.md): Recuperar métricas de uso para las finalizaciones de chat, agregadas de la tabla ChatCompletion. - [Uso de respuestas](https://docs.mka1.com/api-reference/usage/uso-de-respuestas.md): Recuperar métricas de uso de las respuestas de los agentes, agregadas desde la tabla de Respuestas. - [Obtener uso de conversaciones](https://docs.mka1.com/api-reference/usage/obtener-uso-de-conversaciones.md): Recuperar métricas de uso para operaciones de conversación. - [Obtener uso de incrustaciones](https://docs.mka1.com/api-reference/usage/obtener-uso-de-incrustaciones.md): Recuperar métricas de uso para operaciones de incrustación. - [Obtener uso del extracto](https://docs.mka1.com/api-reference/usage/obtener-uso-del-extracto.md): Recuperar métricas de uso para operaciones de extracción. - [Obtener uso de clasificación](https://docs.mka1.com/api-reference/usage/obtener-uso-de-clasificación.md): Recuperar métricas de uso para operaciones de clasificación. - [Obtener uso de almacenes vectoriales](https://docs.mka1.com/api-reference/usage/obtener-uso-de-almacenes-vectoriales.md): Recuperar métricas de uso para operaciones de almacenamiento vectorial. - [Obtener uso de archivos](https://docs.mka1.com/api-reference/usage/obtener-uso-de-archivos.md): Recuperar bytes de archivos creados por periodo a partir de eventos de creación de archivos duraderos. Esto no refleja el almacenamiento retenido actual, los contenedores siguen contándose después de la eliminación de archivos, y los resultados agrupados se colapsan según las dimensiones de salida s… - [Obtener costo por modelo](https://docs.mka1.com/api-reference/usage/obtener-costo-por-modelo.md): Agrupa el gasto por modelo durante un intervalo de tiempo, con precio en la moneda del clúster según el libro de precios del modelo. Alcance por organización: los administradores de la organización ven la suya; los administradores del clúster pueden pasar `org_id`. Incluye trabajo facturable sin una… - [Costo agregado por dimensión](https://docs.mka1.com/api-reference/usage/costo-agregado-por-dimensión.md): Suma el coste almacenado por entrada sobre [start_time, end_time), agrupado por cualquiera de service, task_type, model, api_key_id, team_id, user_id, external_user_id, org_id. Correcto en un punto temporal para chargeback/showback. ### Budgets - [Lista de presupuestos](https://docs.mka1.com/api-reference/budgets/lista-de-presupuestos.md): Los administradores del clúster ven todos los presupuestos; los administradores de la organización ven los presupuestos de su organización (incluidos los presupuestos de los miembros y los presupuestos predeterminados por miembro), además de los presupuestos de las claves de API de su organización. - [Listar presupuestos organizacionales](https://docs.mka1.com/api-reference/budgets/listar-presupuestos-organizacionales.md): Devuelve los presupuestos de la organización (auto-presupuesto y/o límite máximo) con el indicador de gasto en vivo de cada uno. Se dirige a la propia organización del solicitante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional org_id nombre otra org… - [Establecer un presupuesto organizacional](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-organizacional.md): Crea o actualiza un presupuesto para la organización. Un presupuesto por (alcance, propietario); al editarlo se vuelve a evaluar frente al gasto real. Se dirige a la propia organización de quien realiza la llamada (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consul… - [Eliminar un presupuesto de la organización](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-de-la-organización.md): Elimina el presupuesto de la organización para el propietario dado; la aplicación y las alertas se detienen. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión) a menos que el parámetro de consulta opcional org_id nombre otra organización; solo administ… - [Lista de eventos de presupuesto de la organización](https://docs.mka1.com/api-reference/budgets/lista-de-eventos-de-presupuesto-de-la-organización.md): Devuelve los eventos recientes de alerta de umbral y bloqueo para los presupuestos de la organización. Se dirige a la propia organización del solicitante (inferida a partir de la clave de API o la sesión) a menos que el parámetro opcional de consulta org_id especifique otra organización; solo para a… - [Lista de presupuestos de claves API](https://docs.mka1.com/api-reference/budgets/lista-de-presupuestos-de-claves-api.md): Devuelve los presupuestos de la clave API (presupuesto propio y/o límite máximo) junto con el indicador de gasto en tiempo real de cada uno. Puede ser invocado por administradores del clúster, o por administradores de la organización para claves API de su propia organización. - [Establecer un presupuesto de clave API](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-de-clave-api.md): Crea o actualiza un presupuesto para la clave de API. Un presupuesto por (ámbito, propietario); al editarlo, se vuelve a evaluar frente al gasto real. Puede ser llamado por administradores del clúster, o por administradores de la organización para claves de API de su propia organización. - [Eliminar un presupuesto de apikey](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-de-apikey.md): Elimina el presupuesto de la clave API para el propietario especificado; la aplicación y las alertas se detienen. Puede ser invocado por administradores del clúster, o por administradores de la organización para claves API en su propia organización. - [Lista de eventos de presupuesto de apikey](https://docs.mka1.com/api-reference/budgets/lista-de-eventos-de-presupuesto-de-apikey.md): Devuelve los eventos recientes de alerta de umbral y bloqueo para los presupuestos de la clave API. Invocable por administradores del clúster, o por administradores de la organización para claves API de su propia organización. - [Listar presupuestos de usuario](https://docs.mka1.com/api-reference/budgets/listar-presupuestos-de-usuario.md): Devuelve los presupuestos del usuario en la organización objetivo (autopresupuesto y/o límite) con el indicador de gasto en vivo de cada uno. Se dirige a la propia organización del solicitante (inferida a partir de la clave API o la sesión), a menos que el parámetro opcional de consulta org_id indiq… - [Establecer un presupuesto de usuario](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-de-usuario.md): Crea o actualiza un presupuesto para el usuario en la organización de destino. Un presupuesto por (ámbito, propietario); al editarlo, se vuelve a evaluar frente al gasto en tiempo real. Un presupuesto de usuario explícito reemplaza el presupuesto predeterminado por usuario de la organización para el… - [Eliminar el presupuesto de un usuario](https://docs.mka1.com/api-reference/budgets/eliminar-el-presupuesto-de-un-usuario.md): Elimina el presupuesto del usuario para el propietario dado; el presupuesto predeterminado por usuario de la organización (si existe) vuelve a aplicarse. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional… - [Listar eventos de presupuesto del usuario](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-presupuesto-del-usuario.md): Devuelve los eventos recientes de alerta de umbral y de bloqueo para los presupuestos del usuario en la organización de destino. Se dirige a la propia organización del llamante (inferida a partir de la clave API o la sesión), a menos que el parámetro de consulta opcional org_id nombre otra organizac… - [Lista los presupuestos del equipo](https://docs.mka1.com/api-reference/budgets/lista-los-presupuestos-del-equipo.md): Devuelve los presupuestos del equipo en la organización de destino (autopresupuesto y/o límite) con el indicador de gasto en vivo de cada uno. Apunta a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro opcional de consulta org_id nombre… - [Establecer un presupuesto de equipo](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-de-equipo.md): Crea o actualiza un presupuesto para el equipo en la organización de destino. Un presupuesto por (ámbito, propietario); al editarlo, se vuelve a evaluar frente al gasto real. Un presupuesto explícito de equipo reemplaza el presupuesto predeterminado por equipo de la organización con el mismo propiet… - [Eliminar el presupuesto de un equipo](https://docs.mka1.com/api-reference/budgets/eliminar-el-presupuesto-de-un-equipo.md): Elimina el presupuesto del equipo para el propietario dado; el presupuesto predeterminado por equipo de la organización (si existe) vuelve a aplicarse. Se dirige a la propia organización del llamador (inferida a partir de la clave de API o la sesión), a menos que el parámetro opcional de consulta or… - [Listar eventos del presupuesto del equipo](https://docs.mka1.com/api-reference/budgets/listar-eventos-del-presupuesto-del-equipo.md): Devuelve los eventos recientes de alerta de umbral y bloqueo para los presupuestos del equipo en la organización objetivo. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional org_id nombre otra organización… - [Listar presupuestos de usuarios externos](https://docs.mka1.com/api-reference/budgets/listar-presupuestos-de-usuarios-externos.md): Devuelve los presupuestos del usuario externo en la organización de destino (presupuesto propio y/o límite) con el indicador de gasto en vivo de cada uno. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional… - [Establecer un presupuesto de usuario externo](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-de-usuario-externo.md): Crea o actualiza un presupuesto para el usuario externo en la organización de destino. Un presupuesto por (ámbito, propietario); al editarlo, se vuelve a evaluar frente al gasto en vivo. Un presupuesto explícito de usuario externo reemplaza el presupuesto predeterminado por usuario externo de la org… - [Eliminar un presupuesto de usuario externo](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-de-usuario-externo.md): Elimina el presupuesto del usuario externo para el propietario dado; el presupuesto predeterminado por usuario externo de la organización (si existe) se les vuelve a aplicar. Se aplica a la propia organización del llamante (inferida a partir de la clave API o la sesión), a menos que el parámetro de… - [Listar eventos de presupuesto de usuarios externos](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-presupuesto-de-usuarios-externos.md): Devuelve los eventos recientes de alerta de umbral y de bloqueo para los presupuestos del usuario externo en la organización de destino. Se dirige a la propia organización del llamador (inferida a partir de la clave API o la sesión), a menos que el parámetro de consulta opcional org_id especifique o… - [Listar presupuestos predeterminados por usuario](https://docs.mka1.com/api-reference/budgets/listar-presupuestos-predeterminados-por-usuario.md): Devuelve los presupuestos predeterminados por usuario de la organización (definidos por el propio usuario y/o el límite del operador). Un presupuesto predeterminado se aplica a todos los usuarios de la organización frente al contador de gasto propio de ese usuario, a menos que exista para ellos un p… - [Establecer un presupuesto predeterminado por usuario](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-predeterminado-por-usuario.md): Crea o actualiza el presupuesto predeterminado por usuario de la organización: un límite que se aplica a CADA usuario de la organización individualmente (no de forma agregada), a menos que exista para él un presupuesto de usuario explícito con el mismo propietario y período. Las alertas y bloqueos p… - [Eliminar un presupuesto predeterminado por usuario](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-predeterminado-por-usuario.md): Elimina el presupuesto predeterminado por usuario de la organización para el propietario indicado; solo permanecen los presupuestos explícitos de usuario. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional… - [Lista de eventos de presupuesto predeterminado por usuario](https://docs.mka1.com/api-reference/budgets/lista-de-eventos-de-presupuesto-predeterminado-por-usuario.md): Devuelve los eventos recientes de alerta de umbral y de bloqueo para los presupuestos predeterminados por usuario de la organización. El target_id de cada evento indica el usuario para el que se activó. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión… - [Lista de presupuestos predeterminados por equipo](https://docs.mka1.com/api-reference/budgets/lista-de-presupuestos-predeterminados-por-equipo.md): Devuelve los presupuestos predeterminados por equipo de la organización (definidos por el propio usuario y/o el límite del operador). Un presupuesto predeterminado se aplica a todos los equipos de la organización contra el contador de gasto propio de ese equipo, a menos que exista para ellos un pres… - [Establecer un presupuesto predeterminado por equipo](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-predeterminado-por-equipo.md): Crea o actualiza el presupuesto predeterminado por equipo de la organización: un límite que se aplica a CADA equipo de la organización individualmente (no en conjunto), a menos que exista para ellos un presupuesto explícito del equipo con el mismo propietario y período. Las alertas y bloqueos de umb… - [Eliminar un presupuesto predeterminado por equipo](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-predeterminado-por-equipo.md): Elimina el presupuesto predeterminado por equipo de la organización para el propietario dado; solo permanecen los presupuestos de equipo explícitos. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de consulta opcional org_i… - [Lista de eventos de presupuesto predeterminados por equipo](https://docs.mka1.com/api-reference/budgets/lista-de-eventos-de-presupuesto-predeterminados-por-equipo.md): Devuelve los eventos recientes de alerta de umbral y bloqueo para los presupuestos predeterminados por equipo de la organización. El target_id de cada evento indica el equipo para el que se activó. Se dirige a la propia organización del llamante (inferida de la clave de API o la sesión), a menos que… - [Listar presupuestos predeterminados por usuario externo](https://docs.mka1.com/api-reference/budgets/listar-presupuestos-predeterminados-por-usuario-externo.md): Devuelve los presupuestos predeterminados por usuario externo de la organización (establecidos por el propio usuario y/o límite del operador). Un presupuesto predeterminado se aplica a cada usuario externo de la organización respecto al contador de gasto propio de ese usuario externo, a menos que ex… - [Establecer un presupuesto predeterminado por usuario externo](https://docs.mka1.com/api-reference/budgets/establecer-un-presupuesto-predeterminado-por-usuario-externo.md): Crea o actualiza el presupuesto predeterminado por usuario externo de la organización: un límite que se aplica a CADA usuario externo de la organización individualmente (no en conjunto), a menos que exista para ellos un presupuesto explícito de usuario externo con el mismo propietario y período. Las… - [Eliminar un presupuesto predeterminado por usuario externo](https://docs.mka1.com/api-reference/budgets/eliminar-un-presupuesto-predeterminado-por-usuario-externo.md): Elimina el presupuesto predeterminado por usuario externo de la organización para el propietario dado; solo permanecen los presupuestos explícitos de usuarios externos. Se dirige a la propia organización del llamante (inferida a partir de la clave de API o la sesión), a menos que el parámetro de con… - [Listar eventos de presupuesto predeterminados por usuario externo](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-presupuesto-predeterminados-por-usuario-externo.md): Devuelve los eventos recientes de alerta de umbral y bloqueo para los presupuestos predeterminados por usuario externo de la organización. target_id de cada evento indica el usuario externo para el que se activó. Se dirige a la propia organización del solicitante (inferida a partir de la clave de AP… ### Settings - [Obtener moneda de visualización](https://docs.mka1.com/api-reference/settings/obtener-moneda-de-visualización.md) - [Establecer moneda de visualización](https://docs.mka1.com/api-reference/settings/establecer-moneda-de-visualización.md): Código ISO 4217 utilizado para mostrar presupuestos e informes de costes. No se realiza ninguna conversión en ninguna parte. ## OpenAPI Specs - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=es)