# Visão geral das Felo APIs

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

Para pagar por busca na web, leitura da web, dados do X, Chat ou PPT com **saldo da plataforma**, use [Felo no Data API](https://openapi.felo.ai/pt-BR/docs/api-reference/openapi/overview.md). Esta página documenta as APIs `/v2` existentes, que usam **créditos Pro da Felo**.

As APIs Felo são APIs de fluxo de trabalho, de primeira parte, para busca, documentos, apresentações, extração da web, busca social e fluxos de agente. Elas usam a mesma chave da API Felo que o restante da plataforma, mas são cobradas separadamente das chamadas de modelo.

::: tip Créditos de assinatura Felo Pro
**As APIs Felo atualmente aceitam créditos de assinatura Felo Pro.** Isso se aplica às APIs `/v2` de primeira parte nesta seção: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page e SuperAgent.

Isso **não** se aplica a chamadas da API de Modelo (`/api/v1`). Chamadas de modelo exigem créditos de serviço pré-pagos da Felo API Platform; créditos de assinatura Felo Pro não podem ser usados para elas.
:::

A elegibilidade pode mudar. A página [Cobrança do Console](https://openapi.felo.ai/console/billing) é a fonte de verdade para seu saldo e uso atuais.

## APIs nesta seção

| API | Endpoint | Use para |
|---|---|---|
| [API de Busca da Felo](https://openapi.felo.ai/pt-BR/docs/api-reference/chat.md) | `POST /v2/chat` | Busca conversacional na web com análise de consulta, fontes e citações |
| [API de Tarefa de PPT](https://openapi.felo.ai/pt-BR/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Gerar decks de slides e consultar o status da tarefa |
| [API de Mindmap](https://openapi.felo.ai/pt-BR/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Transformar um prompt ou contexto LiveDoc em um mindmap |
| [API LiveDoc](https://openapi.felo.ai/pt-BR/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Criar bases de conhecimento, gerenciar recursos e recuperar contexto |
| [API Web Fetch](https://openapi.felo.ai/pt-BR/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Extrair uma página da web como HTML, texto ou Markdown |
| [API X Search](https://openapi.felo.ai/pt-BR/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Pesquisar usuários do X, tweets, timelines e respostas |
| [API YouTube Subtitling](https://openapi.felo.ai/pt-BR/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Obter legendas e carimbos de tempo do YouTube |
| [API de Tarefa de Landing Page](https://openapi.felo.ai/pt-BR/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Gerar uma landing page de forma assíncrona |
| [API SuperAgent](https://openapi.felo.ai/pt-BR/docs/api-reference/superagent.md) | `POST /v2/conversations` | Executar uma conversa de agente sobre SSE |

## Autenticação e primeira chamada

Crie uma chave da API Felo em [Console → Chaves da API](https://openapi.felo.ai/console/api-keys) e envie-a como um token Bearer.

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

Uma resposta bem-sucedida inclui uma resposta, análise da consulta e recursos web citados.

## Modelo de cobrança

| Superfície | Caminho | Como as chamadas são pagas |
|---|---|---|
| APIs Felo | `/v2/*` | Créditos Pro da Felo |
| [Felo no Data API](https://openapi.felo.ai/pt-BR/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Saldo da plataforma, não créditos Pro |
| API de Modelo | `/api/v1/*` | Somente créditos de serviço pré-pagos da Felo API Platform; Felo Pro não se aplica |
| Data API | `/v1/beta/*` | Usa a base de cobrança do catálogo da API mostrada para cada endpoint |

Créditos Pro da Felo e créditos de serviço da API são saldos separados. Uma assinatura Felo Pro não concede automaticamente créditos de serviço da API, e créditos de serviço da API não adicionam créditos de assinatura Felo Pro.

## Relacionado

- [API de Busca da Felo](https://openapi.felo.ai/pt-BR/docs/api-reference/chat.md)
- [Cobrança e Créditos](https://openapi.felo.ai/pt-BR/docs/faq/billing-and-credits.md)
- [Erros, limites e novas tentativas](https://openapi.felo.ai/pt-BR/docs/guides/errors-and-limits.md)
- [Cobrança do Console](https://openapi.felo.ai/console/billing)