Configuração da API Felo
Provedor: Felo · Pago com saldo da plataforma
A Felo é um provedor em Data API, oferecendo busca na web, leitura da web, dados do X, respostas com base em busca e apresentações. Encontre cada endpoint da Felo junto de outros provedores na categoria relevante do Data API.
Estes endpoints usam saldo da plataforma e o prefixo /api/v1/data. Este guia explica a autenticação, sua primeira solicitação e onde encontrar as regras de cobrança.
Para usar créditos Pro da Felo, consulte as APIs Felo existentes. Saldo da plataforma e créditos Pro são separados.
Faça sua primeira solicitação
- Crie uma chave em Console → Chaves da API.
- Verifique ou recarregue seu saldo da plataforma em Console → Cobrança.
- Defina a chave no seu servidor ou no seu shell local:
export FELO_API_KEY="YOUR_API_KEY"Envie Authorization: Bearer $FELO_API_KEY. X-API-Key também é aceito; escolha um método de autenticação. Solicitações JSON precisam de Content-Type: application/json.
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"What is retrieval augmented generation?","count":3}'HTTP 200 retorna um array resources com títulos de páginas, links e trechos, além de total. Ele não gera uma resposta conversacional; use Chat para isso.
Explore as APIs
| Guia | Operações | O que você recebe | Unidade de cobrança |
|---|---|---|---|
| Busca na Web | Pesquisar a web | Títulos de páginas, links e trechos | Solicitação |
| Leitura da Web | Ler uma URL | Markdown, texto, HTML ou captura de tela | Solicitação |
| Dados do X | Perfis, busca de usuários, posts de usuários, busca de posts, respostas | Usuários e posts estruturados, com paginação quando houver suporte | Resultado retornado |
| Chat com base na busca | Responder a uma pergunta | Resposta e fontes da web | Solicitação |
| PPT | Criar, status, resultados, exportar, status da exportação, excluir | Tarefa de geração e PPTX para download | Página gerada; exportação cobrada separadamente |
| Cobrança e Erros | Orientação de integração compartilhada | Preços, tratamento de saldo e regras de nova tentativa | — |
Há 14 operações principais nesses guias. Se a criação de PPT retornar uma stream_key, o guia de PPT também explica como ler eventos de geração com SSE. Consultas de status e de resultado, consultas de status de exportação e exclusão não criam nova cobrança.
Antes de mover uma integração existente
Use o guia do endpoint exato que você chama. Substituir /v2 por /api/v1/data não é uma migração completa:
- A Leitura da Web usa
/web/read, com um formato de saída por solicitação. - Chat retorna
status: "ok"; ele suporta apenas JSON sem streaming. - Resultados de PPT usam POST
/tasks/{task_id}/historical. - A criação de PPT retorna identificadores na raiz do JSON. Salve
task_ideppt_business_id. - PPTs gerados expiram após sete dias. Exporte e salve seu arquivo antes da expiração.
Não há, documentado aqui, um equivalente OpenAPI nativo para todos os fluxos /v2, como CRUD do LiveDoc, Mindmap ou SuperAgent. Continue usando seus guias das APIs Felo e a cobrança por créditos Pro.
Contrato e preços atuais
- Esquema OpenAPI publicado — definições de campos e esquemas de resposta.
- Esquema YAML OpenAPI — para ferramentas que aceitam YAML.
- Preços atuais — IDs de operação, unidades de cobrança e tarifas atuais.
Esses recursos são públicos e podem ser lidos sem uma chave. Consulte Cobrança e Erros antes de adicionar novas tentativas automáticas.