# n8n

Sambungkan n8n kepada Felo Model API untuk penjanaan dan alat HTTP Data API berasingan untuk carian.

Sambungkan n8n kepada Felo Model API untuk penjanaan dan alat HTTP Data API berasingan untuk carian.

## Persediaan

Cipta API key dan semak baki. Contoh menggunakan Tavily Search; API lain mempunyai parameter dan harga sendiri.

- [API Keys](https://openapi.felo.ai/console/api-keys)
- [Data APIs](https://openapi.felo.ai/ms/apis)
- [Tavily](https://openapi.felo.ai/ms/apis/tavily)

## Tetapan aplikasi

Buka **Workflow → HTTP Request → Import cURL / Send Body → JSON → Execute step**, simpan nilai di bawah dan uji permintaan. Nama menu berbeza mengikut versi.

## Sambungkan carian

```text
HTTP Request → results[] → next node / agent context
JSON output: {{$json.results}}
```

Import fail OpenAPI atau cipta HTTP POST JSON. Simpan key dalam kelayakan; gunakan query sebagai input dan hantar results ke langkah seterusnya.

[OpenAPI JSON](https://openapi.felo.ai/docs-assets/integrations/felo-data-search.openapi.json)

## Permintaan Data API

| Field | Value |
| --- | --- |
| Method | `POST` |
| URL | `https://openapi.felo.ai/v1/beta/tavily/search` |
| Authorization | `Bearer YOUR_FELO_API_KEY` |
| OpenAPI credential | `X-API-Key: YOUR_FELO_API_KEY` |
| Content-Type | `application/json` |
| query | `Felo API Platform documentation` |
| max_results | `3` |
| Output | `results[].title`, `results[].url`, `results[].content` |

```json
{
  "query": "Felo API Platform documentation",
  "max_results": 3
}
```

```bash
export FELO_API_KEY='YOUR_FELO_API_KEY'
curl 'https://openapi.felo.ai/v1/beta/tavily/search' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "Felo API Platform documentation",
  "max_results": 3
}'
```

## Sambungkan Model API

Salin Model ID daripada katalog dan gunakan Base URL serasi OpenAI. Tetapkan Data API sebagai alat HTTP berasingan.

Buka **Workflow → HTTP Request → POST → /api/v1/chat/completions**, simpan nilai di bawah dan uji permintaan. Nama menu berbeza mengikut versi.

| Field | Value |
| --- | --- |
| Base URL | `https://openapi.felo.ai/api/v1` |
| API Key | `YOUR_FELO_API_KEY` |
| Model ID | `YOUR_MODEL_ID` |
| HTTP POST | `https://openapi.felo.ai/api/v1/chat/completions` |
| Output | `choices[0].message.content` |

[Model ID](https://openapi.felo.ai/ms/models) · [Protocols](https://openapi.felo.ai/ms/docs/guides/protocols.md)

```json
{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}
```

```bash
curl 'https://openapi.felo.ai/api/v1/chat/completions' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'
```

## Pengesahan

Semak title, url dan content dalam results. Minta ringkasan dengan URL sumber dan semak penggunaan Felo di konsol. Tatasusunan kosong masih sah.

## Penyelesaian masalah

401: key dan Authorization; 402: baki; 400: JSON dan query. Cuba 429/5xx semula dengan sela meningkat. Simpan request_id. Semak juga kebenaran Workspace atau key persekitaran pelaksanaan.

## Dokumentasi Felo berkaitan

- [Data API](https://openapi.felo.ai/ms/docs/guides/data-api.md)
- [API Reference](https://openapi.felo.ai/ms/docs/data-api)
- [Authentication](https://openapi.felo.ai/ms/docs/authentication.md)
- [Apps & Agents](https://openapi.felo.ai/ms/apps)

## Dokumentasi rasmi aplikasi

- [n8n](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/)
