# Dify

Dify에서 생성용 Felo Model API와 검색용 Data API HTTP 도구를 각각 연결합니다.

Dify에서 생성용 Felo Model API와 검색용 Data API HTTP 도구를 각각 연결합니다.

## 준비 사항

API 키와 잔액을 준비하세요. Tavily 검색 예제이며 다른 API의 매개변수와 가격은 해당 문서를 확인하세요.

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

## 앱 설정

**Studio → Workflow → HTTP Request**에서 아래 값을 저장하고 요청을 테스트하세요. 버전에 따라 화면 이름이 다를 수 있습니다.

## 검색 도구 연결

```text
Start.query → HTTP Request.body.query
HTTP Request.body → LLM context → Output
LLM model → Felo (OpenAI-API-compatible)
```

OpenAPI 파일을 가져오거나 JSON HTTP POST를 만드세요. 키는 자격 증명에 저장하고 query를 입력으로, results를 다음 단계로 전달하세요.

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

## 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
}'
```

## 모델 API 연결

모델 목록에서 Model ID를 복사하고 OpenAI 호환 Base URL을 설정하세요. Data API는 별도 HTTP 도구로 설정합니다.

**Settings → Model Providers → OpenAI-API-compatible**에서 아래 값을 저장하고 요청을 테스트하세요. 버전에 따라 화면 이름이 다를 수 있습니다.

| 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/ko/models) · [Protocols](https://openapi.felo.ai/ko/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
}'
```

## 작동 확인

results의 title, url, content를 확인하고 에이전트에 결과와 출처 URL을 사용하도록 요청하세요. 빈 배열도 정상입니다. 콘솔에서 Felo 사용량을 확인하세요.

## 문제 해결

401: 키와 Authorization, 402: 잔액, 400: JSON과 query를 확인하세요. 429·5xx는 지연 후 재시도하고 request_id를 보관하세요. 시트는 승인·공유 권한, 실행 환경은 키 설정도 확인하세요.

## 관련 Felo 문서

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

## 앱 공식 문서

- [Dify](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
- [Dify Tools](https://docs.dify.ai/en/guides/workflow/node/http-request)
