# Descripción general de las API de Felo

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

Para pagar la búsqueda web, la lectura web, los datos de X, Chat o PPT con **saldo de la plataforma**, usa [Felo en Data API](https://openapi.felo.ai/es/docs/api-reference/openapi/overview.md). Esta página documenta las API `/v2` existentes, que usan **créditos Felo Pro**.

Las API de Felo son APIs de primer nivel, a nivel de flujo de trabajo, para búsqueda, documentos, presentaciones, extracción web, búsqueda social y flujos de trabajo de agentes. Usan la misma clave API de Felo que el resto de la plataforma, pero se facturan por separado de las llamadas a modelos.

::: tip Créditos de suscripción Felo Pro
**Las API de Felo actualmente aceptan créditos de suscripción Felo Pro.** Esto se aplica a las API `/v2` de primer nivel de esta sección: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page y SuperAgent.

Esto no se aplica a las llamadas a la API de modelos (`/api/v1`). Las llamadas a modelos requieren créditos de servicio prepagados de Felo API Platform; los créditos de suscripción Felo Pro no pueden usarse para ellos.
:::

La elegibilidad puede cambiar. La página [Console Billing](https://openapi.felo.ai/console/billing) es la fuente de verdad para tu saldo y uso actuales.

## APIs de esta sección

| API | Endpoint | Úsala para |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/es/docs/api-reference/chat.md) | `POST /v2/chat` | Búsqueda web conversacional con análisis de consulta, fuentes y citas |
| [PPT Task API](https://openapi.felo.ai/es/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Generar diapositivas y consultar el estado de la tarea |
| [Mindmap API](https://openapi.felo.ai/es/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Convertir un prompt o contexto LiveDoc en un mapa mental |
| [LiveDoc API](https://openapi.felo.ai/es/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Crear bases de conocimiento, gestionar recursos y recuperar contexto |
| [Web Fetch API](https://openapi.felo.ai/es/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Extraer una página web como HTML, texto o Markdown |
| [X Search API](https://openapi.felo.ai/es/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Buscar usuarios, tweets, cronologías y respuestas en X |
| [YouTube Subtitling API](https://openapi.felo.ai/es/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Obtener subtítulos y marcas de tiempo de YouTube |
| [Landing Page Task API](https://openapi.felo.ai/es/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Generar una página de aterrizaje de forma asíncrona |
| [SuperAgent API](https://openapi.felo.ai/es/docs/api-reference/superagent.md) | `POST /v2/conversations` | Ejecutar una conversación de agente sobre SSE |

## Autenticación y primera llamada

Crea una clave API de Felo en [Consola → Claves API](https://openapi.felo.ai/console/api-keys) y envíala como 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 respuesta exitosa incluye una respuesta, análisis de consulta y recursos web citados.

## Modelo de facturación

| Superficie | Ruta | Cómo se pagan las llamadas |
|---|---|---|
| API de Felo | `/v2/*` | Créditos Felo Pro |
| [Felo en Data API](https://openapi.felo.ai/es/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Saldo de la plataforma, no créditos Pro |
| API de modelos | `/api/v1/*` | Solo créditos de servicio prepagados de Felo API Platform; Felo Pro no aplica |
| Data API | `/v1/beta/*` | Usa la base de facturación del catálogo de API que se muestra para cada endpoint |

Los créditos Felo Pro y los créditos de servicio de API son saldos separados. Una suscripción Felo Pro no concede automáticamente créditos de servicio de API, y los créditos de servicio de API no añaden créditos de suscripción Felo Pro.

## Relacionado

- [Felo Search API](https://openapi.felo.ai/es/docs/api-reference/chat.md)
- [Facturación y créditos](https://openapi.felo.ai/es/docs/faq/billing-and-credits.md)
- [Errores, límites y reintentos](https://openapi.felo.ai/es/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)