Magpie

Use este guia se você usa o Magpie — o app de barra de menus com gateway local que reúne os modelos de todos os provedores em uma única lista para agentes de código — e quer incluir nessa lista os modelos da Felo API Platform. O Magpie roda um gateway em 127.0.0.1:3425 e reescreve a configuração de cada agente para chamá-lo, então o agente nunca precisa da chave nem do endereço da Felo.

Antes de começar

Você precisa de uma chave da Felo API Platform. A mesma chave serve para os protocolos de modelo, os clientes de agente e as APIs Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Instale o Magpie, caso ainda não tenha:

curl -fsSL https://usemagpie.ai/install.sh | sh

Adicione a Felo como provider

Uma chave da Felo atende Chat Completions, Responses e Anthropic Messages. Passe ao Magpie todos os endereços que ele puder usar:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

No app, Providers → Add provider recebe os mesmos dados: nome felo, a chave e a base OpenAI-compatible https://openapi.felo.ai/api/v1. Para um provider Anthropic-compatible, use https://openapi.felo.ai/api.

Assim que a chave é salva, o Magpie pede a lista de modelos à Felo. Eles aparecem no seletor de cada agente como felo/<model-id>.

magpie provider models felo   # busca a lista da Felo novamente
magpie models                 # o que os agentes podem escolher, incluindo felo/<model>

Escolha um modelo da Felo no agente

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

Ou escolha na página Agents. Como a Felo expõe os três protocolos, cada agente continua no seu: o Claude Code em Anthropic Messages, o Codex em Responses — e ambos chegam à Felo.

Campos do cliente

Verifique a configuração

magpie provider test felo

O Magpie envia uma pequena requisição por protocolo e informa a latência. Depois faça uma pergunta curta a um agente com um modelo felo/ selecionado; se houver resposta, o caminho agente → gateway do Magpie → Felo está funcionando.

Solução de problemas

Próximos passos

• Primeiros passos
• Referência da LLM API
• Modelos e preços
• Solução de problemas