Documentação · API
Invoque a frota por API
Os 65 predadores em 10 camadas respondem por um endpoint só: POST /api/invoke. A chave Bearer age com o seu acesso e gasta a sua quota.
1 · Crie sua chave
Em /settings (planos PRO e APEX), seção Chaves de API, crie uma chave. Ela aparece uma única vez na tela — copie e guarde num lugar seguro, porque depois ela fica mascarada e não dá pra ver de novo. A chave usa o seu plano: a mesma quota e as mesmas camadas, nada a mais. No plano FREE a seção não aparece — faça upgrade pra liberar o acesso por API.
2 · Invoque por curl
Envie o
predator_id e a task com a chave no header Authorization:curl -X POST https://predadores.online/api/invoke \
-H "Authorization: Bearer OWN_sua_chave" \
-H "Content-Type: application/json" \
-d '{"predator_id":"aguia-real","task":"priorize estas tres frentes do trimestre"}'A resposta é um JSON com a saída do predador no campo result. Se vier 401, a chave está errada ou foi revogada — gere outra em /settings. Se vier 403, seu plano não inclui a camada desse predador.
3 · Invoque pela CLI (npx)
A CLI usa a mesma chave (variável de ambiente
PREDATORS_API_KEY):export PREDATORS_API_KEY="OWN_sua_chave"
npx predators-protocol invoke aguia-real "priorize estas tres frentes do trimestre"4 · Limites e segurança
Cada turno é uma invocação e conta na sua quota semanal. Há limite de 30 chamadas por minuto por chave. A chave nunca é armazenada em texto pelo servidor (só o hash). Revogue qualquer chave em /settings — ela para de funcionar na hora.
O comando npx invoke acima já funciona. A integração mais profunda da CLI com o VS Code ainda está em construção. Veja também o produto Dev e os planos.
