Felo API PlatformFelo API Platform

자주 묻는 질문

결제 및 크레딧

서비스 크레딧이 어떻게 차감되는지, 언제 충전이 필요한지, 402 응답의 의미를 설명합니다.

Felo API Platform의 API 사용은 선불 방식입니다. 미국 달러 기준 서비스 크레딧을 구매하고, 각 요청은 적용 요금으로 그 잔액에서 차감됩니다.

결제 방식

  • 충전으로 구매하는 것은 서비스 크레딧이며, 플랫폼이 보관하는 현금 잔액이 아닙니다.
  • 크레딧은 미국 달러 기준이므로 요금을 달러로 표시할 수 있습니다.
  • 충전은 $1부터 가능합니다. 구독은 필요 없습니다.
  • 크레딧은 플랫폼 API 요금을 상쇄하는 데만 사용되며, 출금하거나 현금으로 교환할 수 없습니다.
  • 완료된 충전은 미사용 크레딧을 포함해 환불되지 않습니다. 단, 강행 법규상 필요한 경우는 예외입니다.

같은 크레딧 잔액으로 model call, Data API call, Felo API call을 지불합니다. 공급자마다 별도 계정이나 잔액을 둘 필요가 없습니다.

요청 비용

요금은 endpoint에 따라 다릅니다.

API청구 기준
Model API입력, 출력, 캐시 token 요금에 청구 가능한 도구를 더한 값. 채널의 할인 배수가 적용됩니다
Data API해당 endpoint에 공개된 청구 기준. 성공한 요청당, 반환 항목당 또는 실제 사용량 기준일 수 있습니다
Felo APIs(/v2)해당 워크플로 출력에 대한 요금

모델 가격은 가격 페이지와 각 모델 페이지에 1M tokens당으로 표시됩니다. 계산식과 예시 견적은 모델 및 가격을 참고하세요.

잔액 확인 및 충전

Console Billing을 엽니다. 콘솔에는 현재 크레딧 잔액, 충전 금액, 사용 기록이 표시됩니다. 사용 가능한 결제 수단은 지역에 따라 다르며 결제 시 표시됩니다.

402 응답

402는 잔액이 호출 비용을 감당하지 못한다는 뜻입니다.

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

해야 할 일:

  1. Console Billing에서 잔액을 확인합니다.
  2. 충전합니다.
  3. 요청을 다시 보냅니다. 402는 속도 제한이 아니므로 기다린다고 해결되지 않습니다.

비동기 작업에서 제출 시 402가 나오면 작업이 생성되지 않은 것입니다. 다시 제출하기 전에 작업의 상태 endpoint를 확인하세요.

결제와 속도 제한의 차이

둘은 다른 제한입니다.

  • 크레딧은 얼마나 쓸 수 있는지를 제한합니다. 다 쓰면 402가 반환됩니다.
  • 속도 제한은 얼마나 빨리 호출할 수 있는지를 제한합니다. 초과하면 429가 반환됩니다.

429 헤더와 재시도 규칙은 오류, 속도 제한 및 재시도를 참고하세요.

구독과 크레딧

API 사용은 항상 서비스 크레딧으로 지불합니다. 이 문서에서 설명하는 구독 동작은 유효한 유료 Felo 구독 계정의 /v2/chat 속도 제한 면제뿐이며, 서비스 크레딧을 대체하지 않습니다.

결제 관련 문의

요금에 이의가 있거나 충전이 반영되지 않았다면 다음을 포함해 지원팀에 문의하세요.

  • 계정 email
  • 청구 시각(대략)
  • 관련 오류의 request_id
  • 충전 금액과 결제 참조 번호

전체 API key는 절대 보내지 마세요.

관련 문서