# MKA1: Brazilian Portuguese Referência da API Usage and budgets ## Usage and budgets ### Usage - [Obter uso de completions](https://docs.mka1.com/api-reference/usage/obter-uso-de-completions.md): Recupere métricas de uso para conclusões de chat, agregadas da tabela ChatCompletion. - [Obter uso de respostas](https://docs.mka1.com/api-reference/usage/obter-uso-de-respostas.md): Recuperar métricas de uso para as respostas dos agentes, agregadas da tabela de Respostas. - [Obter uso de conversas](https://docs.mka1.com/api-reference/usage/obter-uso-de-conversas.md): Recuperar métricas de uso para operações de conversa. - [Obter uso de embeddings](https://docs.mka1.com/api-reference/usage/obter-uso-de-embeddings.md): Recuperar métricas de uso para operações de incorporação. - [Obter uso de extrato](https://docs.mka1.com/api-reference/usage/obter-uso-de-extrato.md): Recuperar métricas de uso para operações de extração. - [Obter uso de classificação](https://docs.mka1.com/api-reference/usage/obter-uso-de-classificação.md): Recupere métricas de uso para operações de classificação. - [Obter uso de armazéns de vetores](https://docs.mka1.com/api-reference/usage/obter-uso-de-armazéns-de-vetores.md): Recupere métricas de uso para operações de armazenamento vetorial. - [Obter uso de arquivos](https://docs.mka1.com/api-reference/usage/obter-uso-de-arquivos.md): Recupere bytes de arquivos criados por período a partir de eventos de criação de arquivos duráveis. Isso não reflete o armazenamento retido atual, os buckets continuam contados após a exclusão de arquivos, e os resultados agrupados são colapsados pelas dimensões de saída solicitadas em vez de uma li… - [Obter custo por modelo](https://docs.mka1.com/api-reference/usage/obter-custo-por-modelo.md): Agrega o gasto por modelo ao longo de um intervalo de tempo, precificado na moeda do cluster a partir da tabela de preços do modelo. Com escopo de organização: administradores da org veem sua própria org; administradores do cluster podem passar `org_id`. Inclui trabalho faturável sem uma linha de us… - [Custo agregado por dimensão](https://docs.mka1.com/api-reference/usage/custo-agregado-por-dimensão.md): Soma o custo por entrada armazenado ao longo de [start_time, end_time), agrupado por qualquer um de service, task_type, model, api_key_id, team_id, user_id, external_user_id, org_id. Correto no ponto no tempo para chargeback/showback. ### Budgets - [Listar orçamentos](https://docs.mka1.com/api-reference/budgets/listar-orçamentos.md): Admins de cluster veem todos os orçamentos; administradores da organização veem os orçamentos da sua organização (incluindo orçamentos de membros e orçamentos padrão por membro) além dos orçamentos nas chaves de API da sua organização. - [Listar orçamentos organizacionais](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-organizacionais.md): Retorna os orçamentos da organização (orçamento próprio e/ou teto) com o indicador de gasto em tempo real de cada um. Direciona-se à própria organização do solicitante (inferida da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id especifique outra organização — apenas… - [Definir um orçamento da organização](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-da-organização.md): Cria ou atualiza um orçamento para a organização. Um orçamento por (escopo, proprietário); a edição reavalia em relação aos gastos em tempo real. Aplica-se à própria organização do solicitante (inferida a partir da chave de API ou da sessão), a menos que o parâmetro opcional de consulta org_id espec… - [Excluir um orçamento da organização](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-da-organização.md): Remove o orçamento da organização para o proprietário informado; a aplicação e os alertas são interrompidos. Destina-se à própria organização do chamador (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id informe outra organização — apenas administr… - [Listar eventos orçamentários da organização](https://docs.mka1.com/api-reference/budgets/listar-eventos-orçamentários-da-organização.md): Retorna eventos recentes de alerta de limite e bloqueio para os orçamentos da organização. Destina-se à própria organização do solicitante (inferida da chave da API ou da sessão), a menos que o parâmetro opcional de consulta org_id especifique outra organização — apenas administradores de cluster. - [Listar orçamentos de apikey](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-de-apikey.md): Retorna os orçamentos da chave de API (orçamento próprio e/ou teto) com o indicador de gasto em tempo real de cada um. Chamável por administradores do cluster, ou por administradores da organização para chaves de API em sua própria organização. - [Definir um orçamento de chave de API](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-de-chave-de-api.md): Cria ou atualiza um orçamento para a chave de API. Um orçamento por (escopo, proprietário); a edição reavalia com base no gasto em tempo real. Chamável por administradores do cluster, ou administradores da organização para chaves de API em sua própria organização. - [Excluir um orçamento de chave de API](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-de-chave-de-api.md): Remove o orçamento da apikey do proprietário informado; a aplicação e os alertas são interrompidos. Pode ser chamado por administradores do cluster ou administradores da organização para chaves de API na sua própria organização. - [Liste eventos de orçamento da chave de API](https://docs.mka1.com/api-reference/budgets/liste-eventos-de-orçamento-da-chave-de-api.md): Retorna eventos recentes de alerta de limite e bloqueio para os orçamentos da chave de API. Chamável por administradores de cluster ou administradores da organização para chaves de API em sua própria organização. - [Listar orçamentos do usuário](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-do-usuário.md): Retorna os orçamentos do usuário na organização de destino (orçamento próprio e/ou teto) com o indicador de gasto em tempo real de cada um. Destina-se à própria organização do solicitante (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id especifiqu… - [Definir um orçamento do usuário](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-do-usuário.md): Cria ou atualiza um orçamento para o usuário na organização de destino. Um orçamento por (escopo, proprietário); a edição reavalia com base nos gastos em tempo real. Um orçamento explícito do usuário substitui o orçamento padrão por usuário da organização, com o mesmo proprietário e período, para es… - [Excluir um orçamento de usuário](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-de-usuário.md): Remove o orçamento do usuário para o proprietário fornecido; o orçamento padrão por usuário da organização (se houver) volta a se aplicar a ele. Destina-se à própria organização do chamador (inferida da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id nomeie outra orga… - [Listar eventos de orçamento do usuário](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-orçamento-do-usuário.md): Retorna os eventos recentes de alerta de limite e de bloqueio para os orçamentos do usuário na organização de destino. Tem como alvo a própria organização do chamador (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id informe outra organização — ape… - [Listar orçamentos da equipe](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-da-equipe.md): Retorna os orçamentos da equipe na organização de destino (orçamento próprio e/ou teto) com o indicador de gasto ao vivo de cada um. Aponta para a própria organização do solicitante (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id informe outra or… - [Definir um orçamento da equipe](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-da-equipe.md): Cria ou atualiza um orçamento para a equipe na organização de destino. Um orçamento por (escopo, proprietário); a edição reavalia com base no gasto em tempo real. Um orçamento explícito de equipe substitui o orçamento padrão por equipe da organização com o mesmo proprietário e período para essa equi… - [Excluir um orçamento da equipe](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-da-equipe.md): Remove o orçamento da equipe para o proprietário especificado; o orçamento padrão por equipe da organização (se houver) volta a se aplicar a ele. Tem como alvo a própria organização do chamador (inferida da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id informe outra… - [Listar eventos do orçamento da equipe](https://docs.mka1.com/api-reference/budgets/listar-eventos-do-orçamento-da-equipe.md): Retorna os eventos recentes de alerta de limite e bloqueio para os orçamentos da equipe na organização de destino. Destina-se à própria organização do chamador (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id especifique outra organização — apenas… - [Listar orçamentos de usuários externos](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-de-usuários-externos.md): Retorna os orçamentos do usuário externo na organização de destino (autoorçamento e/ou limite) com o indicador de gasto em tempo real de cada um. Direciona-se à própria organização do chamador (inferida a partir da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id nomei… - [Definir um orçamento externo do usuário](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-externo-do-usuário.md): Cria ou atualiza um orçamento para o usuário externo na organização de destino. Um orçamento por (escopo, proprietário); a edição reavalia em relação ao gasto em tempo real. Um orçamento explícito de usuário externo substitui o orçamento padrão da organização por usuário externo com o mesmo propriet… - [Excluir um orçamento de usuário externo](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-de-usuário-externo.md): Remove o orçamento do usuário externo para o proprietário informado; o orçamento padrão por usuário externo da organização (se houver) volta a ser aplicado a ele. Tem como alvo a própria organização do chamador (inferida da chave de API ou da sessão), a menos que o parâmetro opcional de consulta org… - [Listar eventos de orçamento de usuários externos](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-orçamento-de-usuários-externos.md): Retorna eventos recentes de alerta de limite e de bloqueio para os orçamentos do usuário externo na organização de destino. Tem como alvo a própria organização do solicitante (inferida a partir da chave de API ou da sessão), a menos que o parâmetro opcional de consulta org_id especifique outra organ… - [Listar orçamentos padrão por usuário](https://docs.mka1.com/api-reference/budgets/listar-orçamentos-padrão-por-usuário.md): Retorna os orçamentos padrão por usuário da organização (definidos pelo próprio usuário e/ou teto definido pelo operador). Um orçamento padrão se aplica a todos os usuários da organização em relação ao próprio contador de gastos de cada usuário, a menos que exista para eles um orçamento explícito do… - [Definir um orçamento padrão por usuário](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-padrão-por-usuário.md): Cria ou atualiza o orçamento padrão por usuário da organização: um limite aplicado a CADA usuário da organização individualmente (não em conjunto), a menos que exista para ele um orçamento de usuário explícito com o mesmo proprietário e período. Alertas de limite e bloqueios são acionados por usuári… - [Excluir um orçamento padrão por usuário](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-padrão-por-usuário.md): Remove o orçamento padrão por usuário da organização para o proprietário informado; apenas os orçamentos explícitos do usuário permanecem. Destina-se à própria organização do chamador (inferida pela chave da API ou pela sessão), a menos que o parâmetro opcional de consulta org_id nomeie outra organi… - [Listar eventos de orçamento padrão por usuário](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-orçamento-padrão-por-usuário.md): Retorna eventos recentes de alerta de limite e de bloqueio para os orçamentos padrão por usuário da organização. O target_id de cada evento indica o usuário para o qual ele foi acionado. Destina-se à própria organização do solicitante (inferida pela chave de API ou sessão), a menos que o parâmetro o… - [Lista de orçamentos padrão por equipe](https://docs.mka1.com/api-reference/budgets/lista-de-orçamentos-padrão-por-equipe.md): Retorna os orçamentos padrão por equipe da organização (definidos pela própria equipe e/ou teto do operador). Um orçamento padrão se aplica a todas as equipes da organização em relação ao próprio contador de gastos de cada equipe, a menos que exista um orçamento explícito da equipe com o mesmo propr… - [Defina um orçamento padrão por equipe](https://docs.mka1.com/api-reference/budgets/defina-um-orçamento-padrão-por-equipe.md): Cria ou atualiza o orçamento padrão por equipe da organização: um limite aplicado a CADA equipe na organização individualmente (não em conjunto), a menos que exista para ela um orçamento explícito da mesma titularidade e período. Alertas de limite e bloqueios são acionados por equipe. Destina-se à o… - [Excluir um orçamento padrão por equipe](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-padrão-por-equipe.md): Remove o orçamento padrão por equipe da organização para o proprietário informado; apenas os orçamentos explícitos das equipes permanecem. Tem como alvo a própria organização do solicitante (inferida da chave de API ou da sessão), a menos que o parâmetro de consulta opcional org_id especifique outra… - [Listar eventos de orçamento padrão por equipe](https://docs.mka1.com/api-reference/budgets/listar-eventos-de-orçamento-padrão-por-equipe.md): Retorna os eventos recentes de alerta de limite e bloqueio dos orçamentos padrão por equipe da organização. O target_id de cada evento indica o time para o qual ele foi acionado. Direciona-se à própria organização do solicitante (inferida pela chave da API ou pela sessão), a menos que o parâmetro de… - [Liste os orçamentos padrão por usuário externo](https://docs.mka1.com/api-reference/budgets/liste-os-orçamentos-padrão-por-usuário-externo.md): Retorna os orçamentos padrão por usuário externo da organização (definidos pelo próprio usuário e/ou teto do operador). Um orçamento padrão se aplica a todos os usuários externos da organização em relação ao próprio contador de gastos desse usuário externo, a menos que exista para eles um orçamento… - [Definir um orçamento padrão por usuário externo](https://docs.mka1.com/api-reference/budgets/definir-um-orçamento-padrão-por-usuário-externo.md): Cria ou atualiza o orçamento padrão por usuário externo da organização: um limite aplicado a CADA usuário externo na organização individualmente (não em conjunto), a menos que exista para ele um orçamento explícito de usuário externo com o mesmo proprietário e período. Alertas de limite e bloqueios… - [Excluir um orçamento padrão por usuário externo](https://docs.mka1.com/api-reference/budgets/excluir-um-orçamento-padrão-por-usuário-externo.md): Remove o orçamento padrão por usuário externo da organização para o proprietário informado; apenas os orçamentos explícitos de usuários externos permanecem. Aplica-se à própria organização do chamador (inferida pela chave de API ou sessão), a menos que o parâmetro de consulta opcional org_id especif… - [Listar eventos padrão de orçamento por usuário externo](https://docs.mka1.com/api-reference/budgets/listar-eventos-padrão-de-orçamento-por-usuário-externo.md): Retorna os eventos recentes de alerta de limite e bloqueio para os orçamentos padrão por usuário externo da organização. O target_id de cada evento nomeia o usuário externo para o qual ele foi disparado. Destina-se à própria organização do solicitante (inferida da chave da API ou da sessão), a menos… ### Settings - [Obter moeda de exibição](https://docs.mka1.com/api-reference/settings/obter-moeda-de-exibição.md) - [Definir moeda de exibição](https://docs.mka1.com/api-reference/settings/definir-moeda-de-exibição.md): Código ISO 4217 usado para exibição em orçamentos e relatórios de custos. Nenhuma conversão é realizada em lugar nenhum. ## OpenAPI Specs - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)