# Glossário

> Termos usados na APIcultura, em linguagem direta.

URL: https://apicultura.app/glossario/
Atualizado em 05/11/2026 (2026-11-05).

## 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.