# Configuración de la API de Felo

Configura los endpoints de Felo en Data API para búsqueda, contenido web, datos de X y presentaciones, usando el saldo de la plataforma.

Felo es uno de los proveedores en [Data API](https://openapi.felo.ai/es/docs/data-api), y ofrece búsqueda web, lectura web, datos de X, respuestas con base en búsquedas y presentaciones. Encuentra cada endpoint de Felo junto a otros proveedores en la categoría correspondiente de Data API.

Estos endpoints usan **saldo de la plataforma** y el prefijo `/api/v1/data`. Esta guía explica la autenticación, tu primera solicitud y dónde encontrar las reglas de facturación.

Para usar los créditos Felo Pro, consulta las [API de Felo existentes](https://openapi.felo.ai/es/docs/api-reference/felo-apis.md). El saldo de la plataforma y los créditos Pro son independientes.

## Realiza tu primera solicitud

1. Crea una clave en [Consola → Claves API](https://openapi.felo.ai/console/api-keys).
2. Revisa o recarga tu **saldo de la plataforma** en [Consola → Facturación](https://openapi.felo.ai/console/billing).
3. Configura la clave en tu servidor o en tu shell local:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

Envía `Authorization: Bearer $FELO_API_KEY`. También se acepta `X-API-Key`; elige un método de autenticación. Las solicitudes JSON necesitan `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 devuelve un arreglo `resources` con títulos de página, enlaces y fragmentos, además de `total`. No genera una respuesta conversacional; usa [Chat](https://openapi.felo.ai/es/docs/data-api/guides/felo-chat.md) para eso.

## Explora las APIs

| Guía | Operaciones | Qué recibes | Unidad de facturación |
|---|---|---|---|
| [Búsqueda web](https://openapi.felo.ai/es/docs/data-api/guides/felo-web-search.md) | Buscar en la web | Títulos de página, enlaces y fragmentos | Solicitud |
| [Lectura web](https://openapi.felo.ai/es/docs/data-api/guides/felo-web-read.md) | Leer una URL | Markdown, texto, HTML o captura de pantalla | Solicitud |
| [Datos de X](https://openapi.felo.ai/es/docs/data-api/guides/felo-x-data.md) | Perfiles, búsqueda de usuarios, publicaciones de usuarios, búsqueda de publicaciones, respuestas | Usuarios y publicaciones estructurados, con paginación donde se admite | Resultado devuelto |
| [Chat con base en búsquedas](https://openapi.felo.ai/es/docs/data-api/guides/felo-chat.md) | Responder una pregunta | Respuesta y fuentes web | Solicitud |
| [PPT](https://openapi.felo.ai/es/docs/data-api/guides/felo-ppt.md) | Crear, estado, resultados, exportar, estado de exportación, eliminar | Tarea de generación y PPTX descargable | Página generada; la exportación se factura por separado |
| [Facturación y errores](https://openapi.felo.ai/es/docs/data-api/guides/felo-billing.md) | Guía de integración compartida | Precios, manejo del saldo y reglas de reintento | — |

Hay **14 operaciones principales** en estas guías. Si la creación de PPT devuelve un `stream_key`, la [guía de PPT](https://openapi.felo.ai/es/docs/data-api/guides/felo-ppt.md#leer-eventos-de-generaci-n-con-sse) también explica cómo leer eventos de generación con SSE. Las consultas de estado y resultados, las consultas de estado de exportación y la eliminación no crean un nuevo cargo.

## Antes de mover una integración existente

Usa la guía del endpoint exacto que llamas. Sustituir `/v2` por `/api/v1/data` no es una migración completa:

- Web Read usa `/web/read`, con un único formato de salida por solicitud.
- Chat devuelve `status: "ok"`; solo admite JSON sin streaming.
- Los resultados de PPT usan **POST** `/tasks/{task_id}/historical`.
- La creación de PPT devuelve identificadores en la raíz JSON. Guarda tanto `task_id` como `ppt_business_id`.
- Los PPT generados caducan después de siete días. Exporta y guarda tu archivo antes de la caducidad.

No existe aquí un equivalente nativo de OpenAPI documentado para todos los flujos `/v2`, como CRUD de LiveDoc, Mindmap o SuperAgent. Sigue usando sus [guías de API de Felo](https://openapi.felo.ai/es/docs/api-reference/felo-apis.md) y la facturación por créditos Pro.

## Contrato y precios actuales

- [Esquema OpenAPI publicado](https://openapi.felo.ai/api/v1/data/openapi.json) — definiciones de campos y esquemas de respuesta.
- [Esquema YAML de OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.yaml) — para herramientas que aceptan YAML.
- [Precios actuales](https://openapi.felo.ai/api/v1/data/prices) — IDs de operación, unidades de facturación y tarifas actuales.

Estos recursos son públicos y pueden leerse sin clave. Consulta [Facturación y errores](https://openapi.felo.ai/es/docs/data-api/guides/felo-billing.md) antes de añadir reintentos automáticos.