# Configuração da API Felo

Configure endpoints Felo no Data API para busca, conteúdo da web, dados do X e apresentações, usando o saldo da plataforma.

A Felo é um provedor em [Data API](https://openapi.felo.ai/pt-BR/docs/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](https://openapi.felo.ai/pt-BR/docs/api-reference/felo-apis.md). Saldo da plataforma e créditos Pro são separados.

## Faça sua primeira solicitação

1. Crie uma chave em [Console → Chaves da API](https://openapi.felo.ai/console/api-keys).
2. Verifique ou recarregue seu **saldo da plataforma** em [Console → Cobrança](https://openapi.felo.ai/console/billing).
3. Defina a chave no seu servidor ou no seu shell local:

```bash
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`.

```bash
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](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-chat.md) para isso.

## Explore as APIs

| Guia | Operações | O que você recebe | Unidade de cobrança |
|---|---|---|---|
| [Busca na Web](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-web-search.md) | Pesquisar a web | Títulos de páginas, links e trechos | Solicitação |
| [Leitura da Web](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-web-read.md) | Ler uma URL | Markdown, texto, HTML ou captura de tela | Solicitação |
| [Dados do X](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-x-data.md) | 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](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-chat.md) | Responder a uma pergunta | Resposta e fontes da web | Solicitação |
| [PPT](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-ppt.md) | 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](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-billing.md) | 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](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-ppt.md#leia-eventos-de-gera-o-com-sse) 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_id` e `ppt_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](https://openapi.felo.ai/pt-BR/docs/api-reference/felo-apis.md) e a cobrança por créditos Pro.

## Contrato e preços atuais

- [Esquema OpenAPI publicado](https://openapi.felo.ai/api/v1/data/openapi.json) — definições de campos e esquemas de resposta.
- [Esquema YAML OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.yaml) — para ferramentas que aceitam YAML.
- [Preços atuais](https://openapi.felo.ai/api/v1/data/prices) — 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](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-billing.md) antes de adicionar novas tentativas automáticas.