Felo API PlatformFelo API Platform

가이드

Data API 개요

공통 prefix를 통해 서드파티 endpoint를 호출하고 인증과 요청 처리를 일관되게 유지하세요.

Data API는 하나의 Felo key 뒤에 있는 서드파티 API 카탈로그입니다. Felo 자체 /v2 API 및 Model API와는 별개입니다.

공통 prefix

https://openapi.felo.ai/v1/beta

참조 문서는 각 endpoint를 /v1/beta로 시작하는 전체 경로로 보여 줍니다. host에서는 그 경로를 그대로 사용하고, 공통 prefix를 다시 붙이지 마세요. 예를 들어 Tavily 검색 endpoint는 다음과 같습니다.

POST https://openapi.felo.ai/v1/beta/tavily/search

endpoint 찾기

  • 공급자별로 API 디렉터리를 둘러보세요.
  • 전체 endpoint 목록, 파라미터, 응답 schema는 Data API 참조에서 확인하세요.
  • 참조 문서의 tag를 사용해 공급자 사이를 이동하세요.

각 공급자는 자체 요청 형태를 유지합니다. 공통 계층이 표준화하는 것은 인증과 라우팅이며 payload가 아닙니다. 요청을 보내기 전에 endpoint schema를 읽으세요.

인증

다음 헤더 중 하나를 사용하세요.

Authorization: Bearer $FELO_API_KEY

또는:

X-API-Key: $FELO_API_KEY

JSON 본문에는 Content-Type: application/json을 보내세요.

요청 예시

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

응답 형태는 공급자가 결정합니다. results, pagination cursor, metadata 같은 필드는 공급자마다 정규화되지 않습니다.

규칙

주제예상되는 것
Payload공급자별 JSON. endpoint schema를 따르세요
Pagination필드 이름과 cursor 방식이 endpoint마다 다릅니다
Errorsstatus, code, message, request_id가 있는 JSON. 공급자 세부 정보가 message에 나타날 수 있습니다
Rate limitsendpoint와 공급자에 따라 다릅니다. 부하가 높으면 429를 예상하세요
Billing호출당 청구되며 Model API와 같은 서비스 크레딧 잔액을 사용합니다

오류 처리

인증 실패는 플랫폼의 나머지 부분과 같은 envelope를 반환합니다.

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

공급자 수준의 실패라면 HTTP 상태와 message를 읽으세요. method, 전체 경로, 요청 본문 형태, request_id를 기록하세요. 전체 API key는 기록하지 마세요.

재시도

429와 5xx 응답은 backoff와 함께 재시도하세요. 400이나 401은 그대로 재시도하지 마세요. 일부 공급자 작업은 반복 실행에 안전하지 않습니다. 쓰기 작업을 재시도하기 전에 endpoint를 확인하세요.

언제 Felo API를 쓸까요?

특정 서드파티 데이터 소스가 필요하면 Data API를 사용하세요. Felo 자체 워크플로가 필요하면 Felo API를 사용하세요.

관련 문서