# Felo 검색 기반 채팅

POST /api/v1/data/chat

질문을 보내면 한 번의 응답으로 웹 소스가 포함된 생성형 답변을 받습니다.

모든 예시는 [개요](https://openapi.felo.ai/ko/docs/data-api/guides/felo-overview.md)의 `FELO_API_KEY`를 사용합니다. 호출은 Felo Pro 크레딧이 아니라 **플랫폼 잔액**을 사용합니다. 응답 예시는 설명용이며, 실제 콘텐츠와 선택적 필드는 달라질 수 있습니다.

## 엔드포인트

`POST /api/v1/data/chat`

이 엔드포인트는 플랫폼 잔액을 사용하는 것입니다. `/v2/chat`의 [Felo Search API](https://openapi.felo.ai/ko/docs/api-reference/chat.md)는 Pro 크레딧을 사용하며 응답 구조가 다릅니다.

## 요청

| 필드 | 유형 | 필수 | 의미 |
|---|---|---|---|
| `query` | string | 예 | 질문, 1–2,000자 |
| `accept_language` | string | 아니오 | 선호 답변 언어, 예: `en`, `ja`, `zh-CN`; 최대 64자 |
| `stream` | boolean | 아니오 | `false`여야 함; 기본값은 `false` |

2–8자의 언어 코드와 선택적 하이픈 구분 하위 태그를 포함한 언어 태그를 사용하세요. 예: `zh-TW`. 서비스는 이 선호를 생성 요청에 추가합니다. 생략하면 상위 서비스가 언어를 선택하며, 고정 기본값은 없습니다. 영어 질문이라고 해서 영어 답변이 보장되지는 않습니다. 이 선호는 생성된 답변에만 적용되며, 소스 제목과 발췌문은 원래 언어를 유지합니다.

이 엔드포인트는 비스트리밍 JSON을 반환합니다. `stream: true`, SSE, `messages` 배열 또는 모델 선택은 지원하지 않습니다.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/chat" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Explain retrieval augmented generation and cite sources.","accept_language":"en","stream":false}'
```

## 응답

HTTP 200은 `status: "ok"`와 `data` 객체를 반환합니다:

```json
{
  "status": "ok",
  "data": {
    "id": "example-chat-id",
    "message_id": "example-message-id",
    "answer": "Retrieval augmented generation adds retrieved context to a model request...",
    "resources": [
      {"title":"Example reference","link":"https://example.com/guide","snippet":"An overview of retrieval augmented generation."}
    ],
    "query_analysis": {"queries":["retrieval augmented generation"]}
  }
}
```

| 필드 | 의미 |
|---|---|
| `data.answer` | 생성된 답변 |
| `data.resources` | 제목, 링크, 스니펫이 포함된 소스 페이지 |
| `data.query_analysis` | 선택적 쿼리 분석; null일 수 있음 |
| `data.id`, `data.message_id` | 응답 식별자 |

먼저 HTTP 상태를 확인한 다음 답변과 소스를 읽으세요. `/v2/chat`처럼 숫자 `status: 200`를 검사하지 마세요.

## 청구

`chat`은 모델 토큰이 아니라 요청당 과금됩니다. [현재 가격](https://openapi.felo.ai/api/v1/data/prices)과 [청구 및 오류](https://openapi.felo.ai/ko/docs/data-api/guides/felo-billing.md)를 참조하세요.