# Panoramica delle API Felo

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

Per pagare la ricerca web, la lettura web, i dati X, Chat o PPT con **il saldo della piattaforma**, usa [Felo in Data API](https://openapi.felo.ai/it/docs/api-reference/openapi/overview.md). Questa pagina documenta le API `/v2` esistenti, che usano i **crediti Felo Pro**.

Le API Felo sono API first-party a livello di workflow per ricerca, documenti, presentazioni, estrazione web, ricerca social e workflow agent. Usano la stessa API key Felo del resto della piattaforma, ma sono fatturate separatamente dalle chiamate ai modelli.

::: tip Crediti da abbonamento Felo Pro
**Le API Felo attualmente accettano i crediti dell'abbonamento Felo Pro.** Questo vale per le API `/v2` first-party in questa sezione: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page e SuperAgent.

Questo non vale per le chiamate Model API (`/api/v1`). Le chiamate ai modelli richiedono crediti di servizio Felo API Platform prepagati; i crediti da abbonamento Felo Pro non possono essere usati per queste.
:::

L'idoneità può cambiare. La pagina [Console Billing](https://openapi.felo.ai/console/billing) è la fonte di verità per il tuo saldo e utilizzo attuali.

## API in questa sezione

| API | Endpoint | Usala per |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/it/docs/api-reference/chat.md) | `POST /v2/chat` | Ricerca web conversazionale con analisi della query, fonti e citazioni |
| [PPT Task API](https://openapi.felo.ai/it/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Generare presentazioni e interrogare lo stato del task |
| [Mindmap API](https://openapi.felo.ai/it/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Trasformare un prompt o un contesto LiveDoc in una mindmap |
| [LiveDoc API](https://openapi.felo.ai/it/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Creare knowledge base, gestire risorse e recuperare contesto |
| [Web Fetch API](https://openapi.felo.ai/it/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Estrarre una pagina web come HTML, testo o Markdown |
| [X Search API](https://openapi.felo.ai/it/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Cercare utenti X, tweet, timeline e risposte |
| [YouTube Subtitling API](https://openapi.felo.ai/it/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Recuperare sottotitoli YouTube e timestamp |
| [Landing Page Task API](https://openapi.felo.ai/it/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Generare una landing page in modo asincrono |
| [SuperAgent API](https://openapi.felo.ai/it/docs/api-reference/superagent.md) | `POST /v2/conversations` | Eseguire una conversazione agent su SSE |

## Autenticazione e prima chiamata

Crea una API key Felo in [Console → API Keys](https://openapi.felo.ai/console/api-keys) e inviala come 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?"}'
```

Una risposta riuscita include una risposta, l'analisi della query e risorse web citate.

## Modello di fatturazione

| Interfaccia | Percorso | Come vengono pagate le chiamate |
|---|---|---|
| API Felo | `/v2/*` | Crediti Felo Pro |
| [Felo in Data API](https://openapi.felo.ai/it/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Saldo della piattaforma, non crediti Pro |
| Model API | `/api/v1/*` | Solo crediti di servizio Felo API Platform prepagati; Felo Pro non si applica |
| Data API | `/v1/beta/*` | Usa la base di fatturazione del catalogo API mostrata per ciascun endpoint |

I crediti Felo Pro e i crediti di servizio API sono saldi separati. Un abbonamento Felo Pro non concede automaticamente crediti di servizio API, e i crediti di servizio API non aggiungono crediti dell'abbonamento Felo Pro.

## Correlati

- [Felo Search API](https://openapi.felo.ai/it/docs/api-reference/chat.md)
- [Fatturazione e crediti](https://openapi.felo.ai/it/docs/faq/billing-and-credits.md)
- [Errori, limiti e retry](https://openapi.felo.ai/it/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)