GloopAPI 연동 가이드
요금
예약, 정산과 파일 저장을 이해합니다.
모델 카탈로그, 공개 가격 요약과 실제 호출 과금은 서로 다른 정보를 제공합니다. 유료 작업을 시작하기 전에 모델 또는 도구, 입력과 예산을 확인하세요. 잔액이 충분하다고 호출 권한이 있는 것은 아닙니다.
예약과 정산
요청이 접수되면 예상 할당량이 예약될 수 있습니다. 신뢰할 수 있는 사용량이 확보되면 고정된 가격으로 정산하고 차액을 추가 청구하거나 환불합니다. 사용량 기반 동영상 견적은 추정치이며 최대 지출 보장이 아닙니다. 도구의 최대 예약액은 입력 한도와 고정된 규칙으로 계산되며 생성 시 비용 상한을 검사합니다.
status=succeeded는 실행 상태를 나타내며 billing.status=reserved이면 요금은 여전히 확인 대기 중입니다. 최종 금액이 null이라고 0은 아닙니다. 서비스 제출 결과가 불명확하거나 사용량이 충돌하면 검증할 때까지 예약을 유지합니다. 확인된 실패에 대한 환불은 엔드포인트와 사용량 증거에 따라 달라지며 모든 실패가 무료라는 일괄적인 보장은 없습니다.
동기 텍스트의 최종 사용량은 플랫폼 사용 기록을 확인하세요. 비동기 작업은 해당 요금 상태를 확인하세요. 이전 작업을 정산하려고 다시 생성하지 마세요.
도구 가격 기능
pricing.mode는 고정 호출당 가격인 flat, 입력으로 사전 계산하는 input, 최종 사용량 기반인 usage를 구분합니다. schema_version은 규칙 형식만 설명합니다. flat에서 amount는 0을 포함한 완전한 고정 가격이며 input/usage는 오해를 부르는 고정 amount를 노출하지 않습니다.
pricing.quote_required는 새 호출에 견적이 필요한지를 결정합니다. requires_usage는 플랫폼 정산 제약을 포함하여 최종 정산에 신뢰할 수 있는 사용량이 필요한지를 나타냅니다. 판매 가격이 고정이어도 견적과 최종 사용량이 필요할 수 있으므로 이 두 기능 필드로 판단하세요. requires_usage=true이면 max_cost_usd가 maximum_usd 이상이어야 하며 성공 후 신뢰할 수 있는 사용량을 기다려 정산합니다. 최종 사용량이 필요 없는 입력 기반 가격 규칙은 견적 후 서비스 사용량을 기다리지 않고 입력 기반 금액으로 정산할 수 있습니다.
metered_pricing은 최종 사용량이 필요한 새 호출만 제한합니다. 최종 사용량이 불필요한 고정/입력 규칙을 제한하거나 접수된 실행 조회, 원래 요청의 멱등 재전송 또는 고정된 요금 복구를 차단하지 않습니다. 견적은 키, 도구 버전, 정규화된 입력과 가격/소스 설정에 연결됩니다. 고정 가격 도구에 quote_id를 제공한 경우에도 반드시 검증합니다. 카탈로그의 최저 구간 가격이 도구가 무료라는 뜻은 아닙니다.
파일 보관과 공간
일반 API 보관 파일은 배포 환경의 보관 일수에 따라 만료됩니다. 영구 보관 이미지/동영상은 참조 보호로 장기 보관하며 expires_at=0은 고정 만료 시각이 없음을 뜻합니다. 저장 공간 점유와 생성 요금은 별도로 계산하며 준비 완료 전에는 다운로드를 보장하지 않습니다.
영구 보관 작업을 삭제하면 결과와 제거 가능한 참조가 지워지고 백그라운드 정리가 공유되지 않은 파일을 제거합니다. 공유 참조, 요금 기록과 멱등성 기록은 남습니다. 파일을 삭제하거나 저장에 실패해도 이미 발생한 생성 요금이 자동 환불되지는 않습니다. 저장 재시도는 사용 가능한 공간을 요청하고 원래 결과를 재사용하며 다시 생성하지 않습니다.
할당량 부족
403, 402 또는 할당량 오류가 나면 먼저 계정과 키 한도를 확인하세요. 영구 보관 인증은 할당량이 소진된 유효한 키의 기록 조회를 허용하지만 새 작업에는 여전히 예산이 필요합니다. 기존 작업이 정산 대기 중이면 원래 기록을 계속 조회하고 다른 API 키나 요청 키로 다시 제출하지 마세요. 인증과 비동기 작업과 멱등성을 참고하세요.