자주 묻는 질문
결제 및 크레딧
서비스 크레딧이 어떻게 차감되는지, 언제 충전이 필요한지, 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": "..."
}해야 할 일:
- Console Billing에서 잔액을 확인합니다.
- 충전합니다.
- 요청을 다시 보냅니다. 402는 속도 제한이 아니므로 기다린다고 해결되지 않습니다.
비동기 작업에서 제출 시 402가 나오면 작업이 생성되지 않은 것입니다. 다시 제출하기 전에 작업의 상태 endpoint를 확인하세요.
결제와 속도 제한의 차이
둘은 다른 제한입니다.
- 크레딧은 얼마나 쓸 수 있는지를 제한합니다. 다 쓰면 402가 반환됩니다.
- 속도 제한은 얼마나 빨리 호출할 수 있는지를 제한합니다. 초과하면 429가 반환됩니다.
429 헤더와 재시도 규칙은 오류, 속도 제한 및 재시도를 참고하세요.
구독과 크레딧
API 사용은 항상 서비스 크레딧으로 지불합니다. 이 문서에서 설명하는 구독 동작은 유효한 유료 Felo 구독 계정의 /v2/chat 속도 제한 면제뿐이며, 서비스 크레딧을 대체하지 않습니다.
결제 관련 문의
요금에 이의가 있거나 충전이 반영되지 않았다면 다음을 포함해 지원팀에 문의하세요.
- 계정 email
- 청구 시각(대략)
- 관련 오류의
request_id - 충전 금액과 결제 참조 번호
전체 API key는 절대 보내지 마세요.