Primeiros passos com Apiário Dev: usando o CLI `npx apiario`

Você nunca usou uma API de LLM? Não se preocupe — você não precisa de dashboard, browser ou chave complexa para começar. Só um terminal e o comando npx apiario.

LLM (Large Language Model, ou modelo de linguagem) é um tipo de inteligência artificial treinada para entender e gerar texto. O Apiário Dev junta vários provedores — DeepSeek, OpenAI, Anthropic, Maritaca — num só lugar, com uma única chave e uma única fatura.

Neste tutorial você vai aprender, sem sair do terminal: instalar sem instalar (sim, com npx), rodar o wizard de setup, fazer a primeira pergunta e gerenciar seus custos. Tudo em menos de 10 minutos.

O mínimo que você precisa saber sobre LLMs

Pense num LLM como um tradutor de prompts: você escreve um texto (o prompt) e ele completa a partir do que aprendeu durante o treinamento. Não é mágica — é matemática estatística em escala gigantesca.

A unidade de medida aqui é o token. Tokens são pedaços de texto — uma palavra, parte de uma palavra ou um caractere especial. Em inglês, 1 token equivale a cerca de ¾ de palavra. Em português, a conta varia um pouco.

"Olá, mundo!" ≈ 3 tokens   # ["Olá", ",", " mundo!"]
"Apiário Dev é incrível" ≈ 5 tokens

Por que se importar com tokens? Porque o preço de cada requisição é calculado por token. Quanto mais você escreve no prompt e quanto maior a resposta, mais tokens consome. Entender isso é o primeiro passo para controlar gastos — e a boa notícia é que o CLI mostra o custo de cada conversa em tempo real.

Setup: rodando o npx apiario

O único pré-requisito é ter o Node.js 18+ instalado. Se você programa em JavaScript, TypeScript, ou só tem o Node na máquina, já está pronto. Se não tem, baixe no site oficial — a instalação leva dois minutos.

Com o Node instalado, abra o terminal e digite:

npx apiario

Na primeira execução, o npm baixa o pacote automaticamente (sem instalação global) e detecta que é sua primeira vez. Em vez de cair num prompt seco, você é recebido por um wizard interativo — uma interface no próprio terminal que guia cada etapa.

O wizard pede dois ingredientes: sua chave de API e uma URL base. Se você já tem uma conta e uma chave em mãos, o wizard termina em segundos. Caso contrário, vamos criar tudo agora.

Criando sua conta e conseguindo uma chave

Vamos por partes. Acesse platform.apiario.dev/auth no seu navegador.

Login sem senha

O Apiário Dev usa login por código enviado ao e-mail — sem senha para lembrar, sem risco de vazamento.

1. Digite seu e-mail
2. Confira a caixa de entrada (ou spam) para um código de 8 dígitos
3. Cole o código no formulário
4. Pronto: sua conta já existe

Criando sua primeira chave de API

Com a conta criada, você precisa de uma chave de API para conectar o CLI. Acesse o painel de API Keys e clique em “Criar Chave”. Dê um nome para identificar a chave (ex.: “CLI do Notebook”) e confirme.

Assim que a chave é criada, o sistema exibe a string completa uma única vez — algo como:

sk-7a9b3f2c1d8e4a5b6c7d8e9f0a1b2c3d

Copie a chave agora! Por segurança, ela não pode ser visualizada novamente depois que você fechar a janela. Se perder o acesso, crie outra chave — quantas quiser, a qualquer momento.

Volte ao terminal e cole a chave no wizard. Pronto — você está conectado.

Agora que o terminal está conectado à sua conta, você precisa de créditos para usar os modelos.

Recarga mínima de R$ 10

O Apiário Dev é pré-pago: você recarrega créditos e usa até acabar. A recarga mínima é de R$ 10 via PIX (cai na hora) ou cartão de crédito.

Com R$ 10 você faz milhares de conversas com o modelo mais barato. Você não leva susto na fatura porque só gasta o que colocou. Sem crédito rotativo, sem mensalidade, sem surpresa.

Com os créditos na conta, já podemos fazer nossa primeira conversa no terminal.

Sua primeira conversa no terminal

Com o wizard concluído, a TUI abre mostrando um cabeçalho com o modelo ativo e algumas informações úteis. O cursor fica piscando, esperando você digitar.

Vamos começar com uma pergunta simples:

O que é o Apiário Dev?

O modelo padrão é deepseek/deepseek-v4-flash — a escolha mais barata e rápida para começar. A resposta aparece logo abaixo, e o custo estimado daquela troca é mostrado na interface.

Comandos úteis para o dia a dia

Durante a conversa, você pode usar comandos com / para controlar a experiência:

Comando	O que faz
/model	Troca o modelo ativo (ex.: /model gpt-4o-mini)
/cost	Mostra o custo acumulado da sessão atual
/new	Reinicia o histórico da conversa
/help	Lista todos os comandos disponíveis

Digite /cost depois de algumas perguntas e veja o total gasto na sessão. Provavelmente alguns centavos — ou menos.

Escolhendo o modelo certo para cada tarefa

Nem toda tarefa precisa do modelo mais caro. Saber escolher faz você gastar menos e obter resultados mais rápidos. Aqui vai uma comparação rápida:

Modelo	Provider	Preço input (1M tok)	Preço output (1M tok)	Ideal para
DeepSeek v4 Flash	DeepSeek	R$ 0,75	R$ 1,50	Projetos completos com baixíssimo custo
Sabiá 4 Small	Maritaca	R$ 2,00	R$ 6,00	Português, contexto brasileiro
GPT o4 mini	OpenAI	R$ 6,20	R$ 22,00	Tarefas gerais, análise
GPT 5.4	OpenAI	R$ 12,50	R$ 75,00	Tarefas complexas, raciocínio
Claude Haiku 4.5	Anthropic	R$ 5,04	R$ 25,20	Texto longo, documentação

Minha dica: comece com o DeepSeek Flash e só troque se precisar. É o modelo mais barato da plataforma (R$ 0,75 por milhão de tokens de entrada) e, dentro do harness do Apiário, ele dá conta de projetos inteiros — desde gerar código até arquitetar soluções — por centavos. Só migre para um modelo mais caro se a tarefa exigir contexto muito longo, raciocínio multimodal ou qualidade superior de saída.

Use /model no CLI para alternar entre eles na hora:

/model deepseek/deepseek-v4-flash      # mais barato
/model openai/gpt-5.4                  # mais poderoso
/model maritaca/sabia-4-small          # melhor em português

Conclusão e próximos passos

Em menos de 10 minutos você instalou (sem instalar), configurou a conta, fez a primeira pergunta e entendeu como os custos funcionam — tudo sem sair do terminal. Esse é o espírito do Apiário Dev: simplicidade e transparência.

Quer continuar explorando?

• Crie sua conta gratuita em platform.apiario.dev/auth
• Use o modo --json para integrar o CLI com scripts (ex.: npx apiario --json "resuma este texto")
• Envie arquivos via pipe: cat README.md | npx apiario --mode json "explique este projeto"
• Exporte sua conversa com /export para salvar o histórico

O terminal é só o começo. 🐝