# Felo API Kurulumu

Arama, web içeriği, X verileri ve sunumlar için Felo uç noktalarını Data API içinde, platform bakiyesini kullanarak kurun.

Felo, web arama, web okuma, X verileri, arama destekli yanıtlar ve sunumlar sunan [Data API](https://openapi.felo.ai/tr/docs/data-api) içindeki sağlayıcılardan biridir. Her Felo uç noktasını ilgili Data API kategorisinde diğer sağlayıcılarla birlikte bulun.

Bu uç noktalar **platform bakiyesini** ve `/api/v1/data` önekini kullanır. Bu kılavuz kimlik doğrulamayı, ilk isteğinizi ve faturalandırma kurallarını nerede bulacağınızı açıklar.

Felo Pro kredilerini kullanmak için [mevcut Felo API’leri](https://openapi.felo.ai/tr/docs/api-reference/felo-apis.md) bölümüne bakın. Platform bakiyesi ve Pro kredileri ayrıdır.

## İlk isteğinizi yapın

1. [Console → API Keys](https://openapi.felo.ai/console/api-keys) içinde bir anahtar oluşturun.
2. [Console → Billing](https://openapi.felo.ai/console/billing) içinde **platform bakiyenizi** kontrol edin veya bakiye yükleyin.
3. Anahtarı sunucunuzda veya yerel kabuğunuzda ayarlayın:

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

`Authorization: Bearer $FELO_API_KEY` gönderin. `X-API-Key` de kabul edilir; bir kimlik doğrulama yöntemi seçin. JSON istekleri `Content-Type: application/json` gerektirir.

```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, sayfa başlıkları, bağlantılar ve özetlerle birlikte bir `resources` dizisi ve ayrıca `total` döndürür. Konuşma yanıtı üretmez; bunun için [Sohbet](https://openapi.felo.ai/tr/docs/data-api/guides/felo-chat.md) bölümünü kullanın.

## API’leri keşfedin

| Kılavuz | İşlemler | Ne alırsınız | Faturalandırma birimi |
|---|---|---|---|
| [Web Arama](https://openapi.felo.ai/tr/docs/data-api/guides/felo-web-search.md) | Web’de arama yapın | Sayfa başlıkları, bağlantılar ve özetler | İstek |
| [Web Okuma](https://openapi.felo.ai/tr/docs/data-api/guides/felo-web-read.md) | Bir URL okuyun | Markdown, metin, HTML veya ekran görüntüsü | İstek |
| [X Verileri](https://openapi.felo.ai/tr/docs/data-api/guides/felo-x-data.md) | Profiller, kullanıcı arama, kullanıcı gönderileri, gönderi arama, yanıtlar | Desteklenen yerlerde sayfalandırmalı, yapılandırılmış kullanıcılar ve gönderiler | Dönen sonuç |
| [Arama Destekli Sohbet](https://openapi.felo.ai/tr/docs/data-api/guides/felo-chat.md) | Bir soruyu yanıtlayın | Yanıt ve web kaynakları | İstek |
| [PPT](https://openapi.felo.ai/tr/docs/data-api/guides/felo-ppt.md) | Oluşturma, durum, sonuçlar, dışa aktarma, dışa aktarma durumu, silme | Oluşturma görevi ve indirilebilir PPTX | Oluşturulan sayfa; dışa aktarma ayrıca faturalandırılır |
| [Faturalandırma ve Hatalar](https://openapi.felo.ai/tr/docs/data-api/guides/felo-billing.md) | Ortak entegrasyon rehberliği | Fiyatlar, bakiye işleme ve yeniden deneme kuralları | — |

Bu kılavuzlar boyunca **14 temel işlem** vardır. PPT oluşturma bir `stream_key` döndürürse, [PPT kılavuzu](https://openapi.felo.ai/tr/docs/data-api/guides/felo-ppt.md#sse-ile-olu-turma-olaylar-n-okuyun) ayrıca SSE ile oluşturma olaylarının nasıl okunacağını açıklar. Durum ve sonuç sorguları, dışa aktarma-durumu sorguları ve silme yeni bir ücret oluşturmaz.

## Mevcut bir entegrasyonu taşımadan önce

Kullandığınız tam uç nokta için ilgili kılavuza bakın. `/v2` yerine `/api/v1/data` kullanmak tam bir geçiş değildir:

- Web Okuma, istek başına bir çıktı biçimiyle `/web/read` kullanır.
- Sohbet `status: "ok"` döndürür; yalnızca akışsız JSON’u destekler.
- PPT sonuçları **POST** `/tasks/{task_id}/historical` kullanır.
- PPT oluşturma, tanımlayıcıları JSON kökünde döndürür. Hem `task_id` hem de `ppt_business_id` kaydedin.
- Oluşturulan PPT’lerin süresi yedi gün sonra dolar. Süresi dolmadan önce dosyanızı dışa aktarın ve kaydedin.

Burada belgelenen her `/v2` iş akışı için, LiveDoc CRUD, Mindmap veya SuperAgent gibi, yerel bir OpenAPI eşdeğeri yoktur. Onlar için [Felo API’leri kılavuzlarını](https://openapi.felo.ai/tr/docs/api-reference/felo-apis.md) ve Pro-kredi faturalandırmasını kullanmaya devam edin.

## Sözleşme ve güncel fiyatlar

- [Yayınlanan OpenAPI şeması](https://openapi.felo.ai/api/v1/data/openapi.json) — alan tanımları ve yanıt şemaları.
- [OpenAPI YAML şeması](https://openapi.felo.ai/api/v1/data/openapi.yaml) — YAML kabul eden araçlar için.
- [Güncel fiyatlar](https://openapi.felo.ai/api/v1/data/prices) — işlem kimlikleri, faturalandırma birimleri ve güncel oranlar.

Bu kaynaklar herkese açıktır ve bir anahtar olmadan okunabilir. Otomatik yeniden denemeler eklemeden önce [Faturalandırma ve Hatalar](https://openapi.felo.ai/tr/docs/data-api/guides/felo-billing.md) bölümüne bakın.