APIculturaEntrar

Glossário

Termos usados na APIcultura, em linguagem direta.

Atualizado em .

Termos

Agente de IA
Programa baseado em um modelo de linguagem que executa tarefas em várias etapas e chama ferramentas externas para agir ou buscar dados.
API
Interface que permite a um programa usar as funções ou dados de outro serviço por requisições estruturadas.
Endpoint
Uma operação específica de uma API, com seu próprio endereço e preço. Na APIcultura, cada endpoint tem um slug, como serp-search, chamado em /v1/call/{slug}.
Slug
Identificador curto e estável de uma ferramenta ou endpoint, usado em URLs e chamadas.
MCP (Model Context Protocol)
Protocolo aberto que padroniza como agentes de IA descobrem e usam ferramentas. A APIcultura expõe seu catálogo por um servidor MCP (https://api.apicultura.app/mcp).
Gateway de APIs
Camada única entre quem chama e vários serviços: autentica, aplica limites, cobra e repassa a chamada.
Saldo pré-pago
Valor em R$ recarregado antes do uso. Cada chamada concluída debita o saldo; chamadas não são feitas se não houver saldo suficiente.
Reserva (hold)
Antes de cada chamada paga, o preço do endpoint é reservado no saldo. Se a chamada tem sucesso, a reserva é capturada; se falha, é liberada.
Chave de API
Credencial no formato apk_live_<id>_<segredo>, enviada como Authorization: Bearer. Tem escopos e tetos de gasto próprios.
Teto de gasto
Limite diário e mensal, por chave, que impede o agente de gastar além do autorizado. Ao atingir o teto, as chamadas são recusadas (HTTP 403, KEY_SPEND_LIMIT).
Idempotência
Propriedade de repetir o mesmo pedido sem repetir o efeito. Com o mesmo Idempotency-Key e o mesmo corpo, a chamada é cobrada uma vez só.
Favo, Bee e Mel
Os modelos de IA da APIcultura (versão 5.5): Favo é o rápido e econômico, Bee o intermediário e Mel o mais potente. API compatível com OpenAI e Anthropic.
Harness
Programa que coloca um modelo de IA para trabalhar: lê e edita arquivos, roda comandos e chama ferramentas. O harness da APIcultura é um agente de código de terminal (beecode).
Workflow
Receita executável pelo MCP: uma ferramenta workflow_nome que devolve o plano com as chamadas de ferramentas do catálogo já preenchidas, com custo estimado por execução. A chamada do plano é grátis; cada chamada de ferramenta é cobrada normalmente.
GEO
Generative Engine Optimization: práticas para que respostas de IAs generativas citem corretamente uma fonte. Esta seção do site (llms.txt, espelhos em Markdown) segue essa ideia.