Visão geralServiçosEventosRecursos
TermoAI

Preço modelo

7 funções do TermoAI para preço modelo.

// npm install termo_core --save-exact
import * as ai from "termo_core/ai";
// ou: import { ai } from "termo_core";
FunçãoRotaO que faz
buscar_paginador_preco_modeloGET /preco_modeloLista os preços de modelos paginados
criar_preco_modeloPOST /preco_modeloCadastra o preço de um modelo de uma IA
buscar_auto_complete_preco_modeloGET /preco_modelo/autocompleteLista básica de preços de modelos para seleção
buscar_pelo_filtro_preco_modeloGET /preco_modelo/filtroBusca preços de modelos por filtro
buscar_pelo_id_preco_modeloGET /preco_modelo/{id}Busca o preço de um modelo pelo id
atualizar_pelo_id_preco_modeloPATCH /preco_modelo/{id}Atualiza o preço de um modelo
deletar_pelo_id_preco_modeloDELETE /preco_modelo/{id}Exclui o preço de um modelo

buscar_paginador_preco_modelo

GET/preco_modelo Exige credencial

Lista os preços de modelos paginados

Exige qualquer permissão da área gateway. Ordena por IA e modelo. pagina começa em 1 (padrão 1) e tamanho tem padrão 20.

function buscar_paginador_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPaginadorPrecoModelo = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaPrecoModelo>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { buscar_paginador_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_paginador_preco_modelo(credencial_de_acesso, { pagina: 1 });

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PaginaPrecoModelo> · Rust: Result<tipos::PaginaPrecoModelo, ErroAoChamarServico> · veja PaginaPrecoModelo.

criar_preco_modelo

POST/preco_modelo Exige credencial

Cadastra o preço de um modelo de uma IA

Exige a permissão criar da área gateway. O preço vale para todas as chaves da IA (provedor, do catálogo) que usarem o modelo (até 200 caracteres, sem diferenciar maiúsculas). custo_entrada_por_milhao e custo_saida_por_milhao são os R$ de 1M de tokens de entrada e de saída (0 a 1.000.000). Cada uso do gateway grava o preço da hora: numa chave paga vira gasto, numa gratuita vira economia. Usos anteriores ao cadastro continuam sem custo.

function criar_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  corpo_da_requisicao: tipos.PrecoModeloCriar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PrecoModelo>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { criar_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await criar_preco_modelo(credencial_de_acesso, corpo_da_requisicao);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PrecoModelo> · Rust: Result<tipos::PrecoModelo, ErroAoChamarServico> · veja PrecoModelo.

buscar_auto_complete_preco_modelo

GET/preco_modelo/autocomplete Exige credencial

Lista básica de preços de modelos para seleção

Exige qualquer permissão da área gateway. Devolve id, IA e modelo em ordem alfabética do modelo. busca procura o trecho no modelo ou na IA. pagina começa em 1 e tamanho tem padrão 10.

function buscar_auto_complete_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarAutoCompletePrecoModelo = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaPrecoModeloAutoComplete>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { buscar_auto_complete_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_auto_complete_preco_modelo(credencial_de_acesso, { busca: "..." });

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PaginaPrecoModeloAutoComplete> · Rust: Result<tipos::PaginaPrecoModeloAutoComplete, ErroAoChamarServico> · veja PaginaPrecoModeloAutoComplete.

buscar_pelo_filtro_preco_modelo

GET/preco_modelo/filtro Exige credencial

Busca preços de modelos por filtro

Exige qualquer permissão da área gateway. Devolve até 500 preços, por IA e modelo. provedor precisa ser igual ao id da IA; modelo procura o trecho, sem diferenciar maiúsculas.

function buscar_pelo_filtro_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPeloFiltroPrecoModelo = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<Array<tipos.PrecoModelo>>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_filtro_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_filtro_preco_modelo(credencial_de_acesso, { provedor: "..." });

Argumentos

Nome

Tipo

Retorno: Promise<Array<tipos.PrecoModelo>> · Rust: Result<Vec<tipos::PrecoModelo>, ErroAoChamarServico>

buscar_pelo_id_preco_modelo

GET/preco_modelo/{id} Exige credencial

Busca o preço de um modelo pelo id

Exige qualquer permissão da área gateway. chaves é quantas chaves não excluídas da IA usam este preço.

function buscar_pelo_id_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PrecoModelo>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_id_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_id_preco_modelo(credencial_de_acesso, id);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PrecoModelo> · Rust: Result<tipos::PrecoModelo, ErroAoChamarServico> · veja PrecoModelo.

atualizar_pelo_id_preco_modelo

PATCH/preco_modelo/{id} Exige credencial

Atualiza o preço de um modelo

Exige a permissão editar da área gateway. Atualização parcial; a IA não muda. O preço novo vale de uma vez para todas as chaves da IA nos usos seguintes; o histórico guarda o preço da hora.

function atualizar_pelo_id_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  corpo_da_requisicao: tipos.PrecoModeloAtualizar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PrecoModelo>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { atualizar_pelo_id_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await atualizar_pelo_id_preco_modelo(credencial_de_acesso, id, corpo_da_requisicao);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PrecoModelo> · Rust: Result<tipos::PrecoModelo, ErroAoChamarServico> · veja PrecoModelo.

deletar_pelo_id_preco_modelo

DELETE/preco_modelo/{id} Exige credencial

Exclui o preço de um modelo

Exige a permissão deletar da área gateway. Exclusão lógica: os usos seguintes do modelo ficam sem custo; o histórico não muda.

function deletar_pelo_id_preco_modelo(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<void>
Exemplo
import { CredencialDeAcesso } from "termo_core";
import { deletar_pelo_id_preco_modelo } from "termo_core/ai";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
await deletar_pelo_id_preco_modelo(credencial_de_acesso, id);

Argumentos

Nome

Tipo

Retorno: Promise<void> · Rust: Result<(), ErroAoChamarServico> · sem corpo na resposta.

Tipos

Tipos usados pelas funções desta página. O nome é o mesmo nos dois pacotes.

PaginaPrecoModelo

import type { PaginaPrecoModelo } from "termo_core/ai";

export interface PaginaPrecoModelo {
  itens: Array<PaginaPrecoModeloItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaPrecoModeloAutoComplete

import type { PaginaPrecoModeloAutoComplete } from "termo_core/ai";

export interface PaginaPrecoModeloAutoComplete {
  itens: Array<PaginaPrecoModeloAutoCompleteItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaPrecoModeloAutoCompleteItensItem

import type { PaginaPrecoModeloAutoCompleteItensItem } from "termo_core/ai";

export interface PaginaPrecoModeloAutoCompleteItensItem {
  id: string;
  modelo: string;
  provedor: string;
}

PaginaPrecoModeloItensItem

import type { PaginaPrecoModeloItensItem } from "termo_core/ai";

export interface PaginaPrecoModeloItensItem {
  atualizado_em: string;
  chaves: number;
  criado_em: string;
  custo_entrada_por_milhao: number;
  custo_saida_por_milhao: number;
  id: string;
  modelo: string;
  provedor: string;
}

PrecoModelo

import type { PrecoModelo } from "termo_core/ai";

export interface PrecoModelo {
  atualizado_em: string;
  chaves: number;
  criado_em: string;
  custo_entrada_por_milhao: number;
  custo_saida_por_milhao: number;
  id: string;
  modelo: string;
  provedor: string;
}

PrecoModeloAtualizar

import type { PrecoModeloAtualizar } from "termo_core/ai";

export interface PrecoModeloAtualizar {
  custo_entrada_por_milhao?: number | null;
  custo_saida_por_milhao?: number | null;
  modelo?: string | null;
}

PrecoModeloCriar

import type { PrecoModeloCriar } from "termo_core/ai";

export interface PrecoModeloCriar {
  custo_entrada_por_milhao: number;
  custo_saida_por_milhao: number;
  modelo: string;
  provedor: string;
}

Gateway

3 funções do TermoAI para gateway.

Auth

1 função do TermoAI para auth.

Nesta página

buscar_paginador_preco_modelocriar_preco_modelobuscar_auto_complete_preco_modelobuscar_pelo_filtro_preco_modelobuscar_pelo_id_preco_modeloatualizar_pelo_id_preco_modelodeletar_pelo_id_preco_modeloTiposPaginaPrecoModeloPaginaPrecoModeloAutoCompletePaginaPrecoModeloAutoCompleteItensItemPaginaPrecoModeloItensItemPrecoModeloPrecoModeloAtualizarPrecoModeloCriar