가이드
플랫폼 개요
Model API, Data API, Felo APIs 세 계층의 역할과 어디서 시작할지 알아보세요.
Felo API Platform은 하나의 API key로 세 가지 요청 영역을 제공합니다. 세 영역은 같은 계정, 크레딧, key를 공유하지만 해결하는 문제가 다르고 base URL도 다릅니다.
세 가지 API
| API | Base URL | 용도 | 참조 |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1(OpenAI-compatible) 및 https://openapi.felo.ai/api(Anthropic-compatible) | 언어, 이미지, 비디오, 결정 모델을 직접 호출 | Model API |
| Data API | https://openapi.felo.ai/v1/beta | 이름이 있는 서드파티 데이터 및 검색 공급자 호출 | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | Felo 자체 검색, 오피스, 콘텐츠, 추출, 지식 워크플로 사용 | Felo API 참조 |
어떤 API를 써야 할까요?
| 원하는 작업 | 사용할 API |
|---|---|
| 내 코드나 AI 코딩 도구에서 LLM 실행 | Model API |
| Web 검색, citation, query 분석이 포함된 답변 | Chat API(/v2/chat) |
| 슬라이드, landing page, mindmap, 비디오 생성 | 해당 Felo task 또는 model endpoint |
| 지식 베이스를 만들고 검색 | LiveDoc API |
| Tavily, Exa, Apollo 등 이름이 있는 데이터 공급자 호출 | Data API |
| 모델을 특정 업스트림 공급자에 고정 | X-Felo-Channel을 사용하는 Model API |
공통 설정
- Felo API Platform 콘솔에서 API key를 하나 만듭니다.
Authorization: Bearer $FELO_API_KEY로 전송합니다.- 사용량에 따라 미국 달러 기준 서비스 크레딧을 충전합니다.
- 호출할 API에 맞는 base URL을 선택합니다.
같은 key가 이 문서에서 다루는 모든 API에서 동작합니다. 환경별로 key를 따로 쓰면 하나를 교체해도 다른 쪽에 영향을 주지 않습니다.
플랫폼이 더해 주는 것
- 모델과 데이터 공급자마다 계정을 따로 만들 필요 없이 하나의 key.
- 모델 ID, context 한도, 프로토콜, 요금이 포함된 공개 모델 카탈로그.
- 여러 채널로 제공되는 모델에 대해 공급자별로 공개된 가격.
- 콘솔에서 한곳에서 관리하는 사용량과 결제.
다음 단계
- 모델 및 가격 — 카탈로그를 읽고 요청 비용을 계산하세요.
- 채널 및 공급자 라우팅 — 모델을 특정 공급자에 고정하세요.
- 프로토콜 및 SDK — OpenAI-compatible, Responses, Messages 중에서 선택하세요.
- 비동기 작업 — PPT, landing page, 비디오, export 작업을 처리하세요.
- Data API 개요 — 공통 prefix를 통해 서드파티 endpoint를 호출하세요.