SNIPIT 도움말

스니핏 API는 선불 달러 잔액으로 과금합니다. 요청을 보내면 엔드포인트별로 정해진 금액이 워크스페이스 잔액에서 차감됩니다. 잔액은 마이크로달러 정수(1달러 = 1,000,000)로 저장됩니다.

API 잔액은 플랜 요금제에 포함된 하루 크레딧과 별도입니다.

API는 Scale 요금제를 사용하는 워크스페이스에서만 이용할 수 있습니다.

항목

값

소재 검색·유사 소재 검색 1회

$0.02

영상 검색 1회

$0.05

그 외 호출 1회

$0.01

사용량 확인 (GET /v1/usage)

무료

엔드포인트별 금액과 차감되지 않는 경우는 호출 비용을 참고하세요.

개발자 콘솔의 결제에 등록한 결제 수단으로 충전합니다. 1회 충전 금액은 $50 ~ $1,000입니다.

사업자 정보를 등록하지 않으면 결제 금액에 세금 10%가 추가되고, 등록하면 추가되지 않습니다. 세금은 잔액에 포함되지 않습니다.

예: $50을 충전하고 세금 10%가 붙으면 결제 수단에서 $55가 결제되고, 잔액에는 $50이 충전됩니다.

결제가 완료되면 워크스페이스 소유자와 관리자에게 이메일로 알려 드립니다.

자동충전을 켜면 잔액이 기준 금액 이하로 내려갈 때 기본 결제 수단으로 자동 결제됩니다. 자동충전은 기본적으로 꺼져 있으며, 켤 때 아래 값을 변경할 수 있습니다.

설정

기본값

범위

충전 기준 잔액

$1

$1 이상

충전 금액

$50

$50 ~ $1,000

  • 무료 지급분도 잔액에 포함해 계산합니다. 무료 지급분이 남아 있어도 전체 잔액이 기준 금액 이하가 되면 충전됩니다.

  • 자동충전은 요청과 별도로 처리됩니다. 잔액이 부족한 순간에 보낸 요청은 충전을 기다리지 않고402 INSUFFICIENT_BALANCE로 실패합니다.

잔액이 부족하면 402 INSUFFICIENT_BALANCE 오류가 반환되고, 오류 본문의 detail.balance_micro_usd에 남은 잔액이 담깁니다. 이 오류는 기다려도 해소되지 않으므로 잔액을 충전한 뒤 다시 요청하세요. 잔액이 부족해지거나 자동충전이 실패하면 워크스페이스 소유자와 관리자에게 이메일로 안내합니다.

금액이 차감되지 않는 요청(GET /v1/usage)은 잔액이 0이어도 보낼 수 있습니다.

Scale 요금제 유료 구독을 처음 시작하면 $1이 잔액으로 지급됩니다.

  • 같은 소유자에게는 한 번만 지급됩니다.

  • 충전한 잔액은 충전일로부터 1년 동안 사용할 수 있습니다. 충전할 때마다 그 금액에 대해 각각 1년이 적용됩니다.

  • 요청 비용은 유효기간이 먼저 끝나는 잔액부터 차감됩니다.

  • 유효기간이 지난 잔액은 자동으로 소멸하며 환불되지 않습니다.

  • 충전 금액 환불은 고객센터로 요청하세요. 사용 내역을 확인한 뒤 처리해 드립니다.

  • 무료 지급분은 환불되지 않습니다.

개발자 콘솔의 사용량에서 기간별 호출 수와 사용 금액을 키별·엔드포인트별로 확인할 수 있습니다.

요청 하나에 쓴 금액과 남은 잔액은 응답에서 확인할 수 있습니다. 단위는 마이크로달러입니다.

응답 본문

응답 헤더

내용

usage.cost_micro_usd

X-Cost-Micro-Usd

이 요청에서 차감된 금액

usage.balance_micro_usd

X-Balance-Micro-Usd

요청을 처리한 뒤 남은 잔액