# Felo API-Einrichtung

Richte Felo-Endpunkte in der Data API für Suche, Webinhalte, X-Daten und Präsentationen ein und verwende dabei das Plattform-Guthaben.

Felo ist ein Anbieter in der [Data API](https://openapi.felo.ai/de/docs/data-api) und bietet Websuche, Weblesen, X-Daten, suche-gestützte Antworten und Präsentationen. Finde jeden Felo-Endpunkt neben anderen Anbietern in der relevanten Data-API-Kategorie.

Diese Endpunkte verwenden **Plattform-Guthaben** und das Präfix `/api/v1/data`. Dieser Leitfaden erklärt die Authentifizierung, deine erste Anfrage und wo du die Abrechnungsregeln findest.

Wenn du Felo-Pro-Guthaben verwenden möchtest, siehe die [bestehenden Felo APIs](https://openapi.felo.ai/de/docs/api-reference/felo-apis.md). Plattform-Guthaben und Pro-Guthaben sind getrennt.

## Erstelle deine erste Anfrage

1. Erstelle einen Schlüssel in [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Prüfe oder lade dein **Plattform-Guthaben** in [Console → Billing](https://openapi.felo.ai/console/billing) auf.
3. Setze den Schlüssel auf deinem Server oder in deiner lokalen Shell:

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

Sende `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` wird ebenfalls akzeptiert; wähle eine Authentifizierungsmethode. JSON-Anfragen benötigen `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 gibt ein `resources`-Array mit Seitentiteln, Links und Snippets sowie `total` zurück. Es erzeugt keine dialogische Antwort; verwende dafür [Chat](https://openapi.felo.ai/de/docs/data-api/guides/felo-chat.md).

## Entdecke die APIs

| Leitfaden | Operationen | Was du erhältst | Abrechnungseinheit |
|---|---|---|---|
| [Websuche](https://openapi.felo.ai/de/docs/data-api/guides/felo-web-search.md) | Web durchsuchen | Seitentitel, Links und Snippets | Anfrage |
| [Web lesen](https://openapi.felo.ai/de/docs/data-api/guides/felo-web-read.md) | Eine URL lesen | Markdown, Text, HTML oder Screenshot | Anfrage |
| [X-Daten](https://openapi.felo.ai/de/docs/data-api/guides/felo-x-data.md) | Profile, Nutzersuche, Nutzerbeiträge, Beitragsuche, Antworten | Strukturierte Nutzer und Beiträge, mit Paginierung, wo unterstützt | Zurückgegebenes Ergebnis |
| [Suche-gestützter Chat](https://openapi.felo.ai/de/docs/data-api/guides/felo-chat.md) | Eine Frage beantworten | Antwort und Webquellen | Anfrage |
| [PPT](https://openapi.felo.ai/de/docs/data-api/guides/felo-ppt.md) | Erstellen, Status, Ergebnisse, Export, Exportstatus, Löschen | Generierungsaufgabe und herunterladbare PPTX | Generierte Seite; Export separat berechnet |
| [Abrechnung und Fehler](https://openapi.felo.ai/de/docs/data-api/guides/felo-billing.md) | Gemeinsame Integrationshinweise | Preise, Guthabenbehandlung und Wiederholungsregeln | — |

Es gibt **14 Kernoperationen** in diesen Leitfäden. Wenn die PPT-Erstellung einen `stream_key` zurückgibt, erklärt der [PPT-Leitfaden](https://openapi.felo.ai/de/docs/data-api/guides/felo-ppt.md#generierungsereignisse-mit-sse-lesen) auch, wie Generierungsereignisse mit SSE gelesen werden. Status- und Ergebnisabfragen, Export-Status-Abfragen und Löschung erzeugen keine neue Gebühr.

## Vor dem Umzug einer bestehenden Integration

Verwende den Leitfaden für den exakten Endpunkt, den du aufrufst. Das Ersetzen von `/v2` durch `/api/v1/data` ist keine vollständige Migration:

- Web Read verwendet `/web/read` mit genau einem Ausgabeformat pro Anfrage.
- Chat gibt `status: "ok"` zurück; es unterstützt nur nicht-streamendes JSON.
- PPT-Ergebnisse verwenden **POST** `/tasks/{task_id}/historical`.
- Die PPT-Erstellung gibt Kennungen an der JSON-Root zurück. Speichere sowohl `task_id` als auch `ppt_business_id`.
- Erstellte PPTs laufen nach sieben Tagen ab. Exportiere und speichere deine Datei vor dem Ablauf.

Für jeden `/v2`-Workflow ist hier keine native OpenAPI-Entsprechung dokumentiert, etwa für LiveDoc CRUD, Mindmap oder SuperAgent. Verwende weiterhin ihre [Felo APIs-Leitfäden](https://openapi.felo.ai/de/docs/api-reference/felo-apis.md) und Pro-Guthaben-Abrechnung.

## Vertrag und aktuelle Preise

- [Veröffentlichtes OpenAPI-Schema](https://openapi.felo.ai/api/v1/data/openapi.json) — Felddefinitionen und Antwortschemata.
- [OpenAPI-YAML-Schema](https://openapi.felo.ai/api/v1/data/openapi.yaml) — für Werkzeuge, die YAML akzeptieren.
- [Aktuelle Preise](https://openapi.felo.ai/api/v1/data/prices) — Operations-IDs, Abrechnungseinheiten und aktuelle Tarife.

Diese Ressourcen sind öffentlich und können ohne Schlüssel gelesen werden. Siehe [Abrechnung und Fehler](https://openapi.felo.ai/de/docs/data-api/guides/felo-billing.md), bevor du automatische Wiederholungen hinzufügst.