​

청구 모드 빠른 참조

​

빠른 비교

​

각 모드를 사용하는 경우

​

사용자 완료 모드

• ✅ 예측 가능하고 고정된 비용을 원합니다.
• ✅ 기존 라이선스 한도 내에 있습니다.
• ✅ 내부 도구를 구축하고 있습니다.
• ✅ 기존 할당량 할당을 사용하려는 경우
• ✅간편한 비용관리가 필요하신 분

• 내부 챗봇
• 개발 및 테스트
• 저용량 애플리케이션
• 고정예산 프로젝트

​

모델 모드별 사용법

• ✅ 자세한 비용 추적이 필요합니다
• ✅ 고가의 모델을 자주 사용하고 계십니다.
• ✅실제 사용량에 대해서만 비용을 지불하고 싶습니다.
• ✅ 세분화된 사용량 분석이 필요합니다.
• ✅ 대량 요구사항이 있는 경우

• 생산 응용
• 대용량 AI 서비스
• 비용에 민감한 프로젝트
• 다중 모델 애플리케이션

​

API 사용법

curl -X POST "https://{customer.name}.hiperai.ai/api/external/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-nano",
    "prompt": "Hello, world!",
    "user_id": "optional-user-id-for-billing"
  }'

​

속도 제한

​

기본 속도 제한

• 분당 요청 수: 60(구성 가능)
• 시간당 요청: 1,000(구성 가능)
• 일일 한도: 요청 100개(구성 가능)
• 월 한도: 요청 10,000건(구성 가능)

​

청구 모드별 한도

• 사용자 완료: 라이선스 할당량 기준
• 모델별 사용량: 달러 기준 추가 한도

​

SMLTP 정책 통합

​

SMLTP 구성 예

{
  "billingMode": "usage-by-model",
  "allowedSMLTPPolicies": ["public", "internal"],
  "enforceSMLTPPolicies": true,
  "allowedModels": ["openai/gpt-5-nano", "anthropic/claude-sonnet-4.6"]
}

​

구성 예

​

사용자 완료 구성

{
  "billingMode": "user-completions",
  "dailyLimit": 100,
  "monthlyLimit": 1000,
  "allowedModels": ["openai/gpt-5-nano", "anthropic/claude-sonnet-4.6"],
  "allowedSMLTPPolicies": ["public", "internal"],
  "rateLimit": {
    "requestsPerMinute": 60,
    "requestsPerHour": 1000
  }
}

​

모델 구성별 사용량

{
  "billingMode": "usage-by-model",
  "dailyLimit": 500,
  "monthlyLimit": 5000,
  "allowedModels": ["openai/gpt-5-nano", "anthropic/claude-sonnet-4.6"],
  "allowedSMLTPPolicies": ["public", "internal", "confidential"],
  "rateLimit": {
    "requestsPerMinute": 120,
    "requestsPerHour": 2000
  },
  "usageByModel": {
    "enabled": true,
    "dollarLimit": 100.00
  }
}

​

오류 시나리오

​

사용자 완료 오류

​

모델 오류에 따른 사용법

​

마이그레이션 가이드

​

사용자 완성부터 모델별 활용까지

1. 사용자에 대한 모델별 사용 활성화
   # Admin panel: Users > Edit User > Enable Usage by Model
   
2. API 키 구성 업데이트
   {
     "billingMode": "usage-by-model",
     "usageByModel": {
       "enabled": true,
       "dollarLimit": 100.00
     }
   }
   
3. 사용량 및 비용 모니터링
   • 토큰 사용 추적
   • 월간 지출 모니터링
   • 필요에 따라 한도를 조정합니다.

​

모델별 활용부터 사용자 완성까지

1. 사용자에게 할당량이 충분한지 확인
   • 라이선스 등급 확인
   • 월 한도 확인
2. API 키 구성 업데이트
   {
     "billingMode": "user-completions",
     "dailyLimit": 100,
     "monthlyLimit": 1000
   }
   
3. 완료 사용량 모니터링
   • 트랙 완료 횟수
   • 대체 동작이 작동하는지 확인

​

비용 추정

​

사용자 완료 비용

• 고정 비용: 라이선스 등급에 따라 다름
• 추가 비용 없음: 기존 라이선스 이상
• 예측 가능: 웹 인터페이스 사용법과 동일

​

모델 비용별 사용량

• 가변 비용: 토큰 사용량에 따라 다름
• 모델별 가격: 모델별로 요금이 다름
• 예시 비용:
  • GPT-5.1: 공급자 가격이 적용됩니다.
  • Claude Sonnet 4.6: 공급자 가격 적용
  • GPT-5 Nano: 공급자 가격이 적용됩니다.

​

모니터링 팁

​

사용자 완료 모니터링

• 매일 완료 횟수를 추적합니다.
• 할당량 소비 모니터링
• 한도에 가까워지면 알림을 설정하세요.
• 월별 사용 패턴 검토

​

모델 모니터링에 따른 사용량

• 토큰 사용량 및 비용 추적
• 월간 지출 모니터링
• 달러 한도 알림 설정
• 모델별 비용 내역 검토

​

보안 고려 사항

​

두 모드 모두

• 민감한 앱에는 IP 제한 사용
• 정기적으로 API 키 교체
• 비정상적인 활동 모니터링
• 적절한 오류 처리 구현

​

모델별 용도

• 적절한 달러 한도 설정
• 비용 급증 모니터링
• 모델 사용 패턴 검토
• 비용이 많이 드는 모델 사용 추적

​

지원 리소스

​

문서

• 결제 모드 개요
• 한도 및 할당량 - 플랫폼 한도 이해

​

관리자 패널

• API 섹션: API 키 생성 및 관리
• 사용자 섹션: 모델별 사용 활성화

​

일반적인 문제

1. 모델별 사용 불가: 사용자 권한 확인
2. 할당량 초과: 모델별 사용량을 활성화하거나 제한을 늘립니다.
3. 비용 급증: 모델 사용량 검토 및 제한 설정
4. 인증 오류: API 키 및 권한 확인