Chave IA uso
2 funções do TermoAI para chave ia uso.
// npm install termo_core --save-exact
import * as ai from "termo_core/ai";
// ou: import { ai } from "termo_core";| Função | Rota | O que faz |
|---|---|---|
buscar_paginador_chave_ia_uso | GET /chave_ia_uso | Lista os usos das chaves de IA paginados |
buscar_pelo_filtro_chave_ia_uso | GET /chave_ia_uso/filtro | Painel de tokens e custo das chaves de IA |
buscar_paginador_chave_ia_uso
GET/chave_ia_uso Exige credencial
Lista os usos das chaves de IA paginados
Exige qualquer permissão da área gateway. Lista cada uso do gateway, do mais recente para o mais antigo, com a chave, a categoria, o modelo, os tokens, os tokens de entrada e de saída, se a chave era gratuita, os preços por 1M de entrada e de saída e o custo do uso gravados na hora. Aceita os mesmos filtros do painel (inicio, fim, chave_ia_id, gratuita). pagina começa em 1 (padrão 1) e tamanho tem padrão 20.
function buscar_paginador_chave_ia_uso(
credencial_de_acesso: CredencialDeAcesso,
parametros: ParametrosDeBuscarPaginadorChaveIaUso = {},
opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaChaveIaUso>import { CredencialDeAcesso } from "termo_core";
import { buscar_paginador_chave_ia_uso } from "termo_core/ai";
const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_paginador_chave_ia_uso(credencial_de_acesso, { pagina: 1 });Argumentos
Nome
Tipo
Retorno: Promise<tipos.PaginaChaveIaUso> · Rust: Result<tipos::PaginaChaveIaUso, ErroAoChamarServico> · veja PaginaChaveIaUso.
buscar_pelo_filtro_chave_ia_uso
GET/chave_ia_uso/filtro Exige credencial
Painel de tokens e custo das chaves de IA
Exige qualquer permissão da área gateway. Soma os usos do gateway no período (inicio e fim em AAAA-MM-DD, dias no fuso America/Sao_Paulo; padrão os últimos 30 dias até hoje). Devolve os totais (requisições, tokens em chaves gratuitas e pagas, R$ economizado nas gratuitas e R$ gasto nas pagas), a série por dia (todo dia do período, mesmo sem uso) e o resumo por chave e modelo, do mais usado para o menos. O custo de cada uso é o gravado na hora (tokens de entrada e de saída × preço do modelo em preco_modelo), então mudar o preço não reescreve o histórico. No resumo por chave e modelo, custo_entrada_por_milhao e custo_saida_por_milhao são o preço atual (nulos quando o modelo não tem preço) e requisicoes_sem_preco conta os usos gravados sem preço. chave_ia_id e gratuita filtram.
function buscar_pelo_filtro_chave_ia_uso(
credencial_de_acesso: CredencialDeAcesso,
parametros: ParametrosDeBuscarPeloFiltroChaveIaUso = {},
opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.ChaveIaUsoPainel>import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_filtro_chave_ia_uso } from "termo_core/ai";
const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_filtro_chave_ia_uso(credencial_de_acesso, { inicio: "..." });Argumentos
Nome
Tipo
Retorno: Promise<tipos.ChaveIaUsoPainel> · Rust: Result<tipos::ChaveIaUsoPainel, ErroAoChamarServico> · veja ChaveIaUsoPainel.
Tipos
Tipos usados pelas funções desta página. O nome é o mesmo nos dois pacotes.
ChaveIaUsoPainel
import type { ChaveIaUsoPainel } from "termo_core/ai";
export interface ChaveIaUsoPainel {
fim: string;
inicio: string;
por_dia: Array<ChaveIaUsoPorDia>;
por_modelo: Array<ChaveIaUsoPorModelo>;
totais: ChaveIaUsoTotais;
}ChaveIaUsoPorDia
import type { ChaveIaUsoPorDia } from "termo_core/ai";
export interface ChaveIaUsoPorDia {
dia: string;
tokens_gratuitos: number;
tokens_pagos: number;
valor_economizado: number;
valor_gasto: number;
}ChaveIaUsoPorModelo
import type { ChaveIaUsoPorModelo } from "termo_core/ai";
export interface ChaveIaUsoPorModelo {
apelido: string;
chave_ia_id: string;
custo: number;
custo_entrada_por_milhao?: number | null;
custo_saida_por_milhao?: number | null;
gratuita: boolean;
modelo: string;
preco_modelo_id?: string | null;
provedor: string;
requisicoes: number;
requisicoes_sem_preco: number;
tokens: number;
tokens_entrada: number;
tokens_saida: number;
}ChaveIaUsoTotais
import type { ChaveIaUsoTotais } from "termo_core/ai";
export interface ChaveIaUsoTotais {
requisicoes: number;
tokens_gratuitos: number;
tokens_pagos: number;
valor_economizado: number;
valor_gasto: number;
}PaginaChaveIaUso
import type { PaginaChaveIaUso } from "termo_core/ai";
export interface PaginaChaveIaUso {
itens: Array<PaginaChaveIaUsoItensItem>;
pagina: number;
tamanho: number;
total: number;
}PaginaChaveIaUsoItensItem
import type { PaginaChaveIaUsoItensItem } from "termo_core/ai";
export interface PaginaChaveIaUsoItensItem {
apelido: string;
categoria: string;
chave_ia_id: string;
criado_em: string;
custo: number;
custo_entrada_por_milhao: number;
custo_saida_por_milhao: number;
gratuita: boolean;
id: string;
modelo: string;
provedor: string;
tokens: number;
tokens_entrada: number;
tokens_saida: number;
}