Kitta Audio Docs
API 참조용법
Back to site

용법

해외 통합을 위한 계정 사용량, 크레딧, 할당량을 확인하세요.

용법

해외통합의 경우 금일 안정계좌 확인은 프로필 입니다. 대규모 작업 전에 크레딧, 계층 및 남은 API 할당량을 읽는 데 사용합니다. 전용 사용 엔드포인트는 스키마 기반: GET /api/openapi.json에 있는 호출 전용 경로로 처리되어야 합니다.

요구

프로필은 일반적인 전달자 인증 요청을 사용합니다.

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY
curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

응답

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

예약이 아닌 운영 가드레일에 대한 응답을 사용하세요. 잔액 확인 후 다른 작업자가 잔액을 소모할 수 있습니다.

청구 및 크레딧

값비싼 배치에 대한 균형 스냅샷을 저장합니다. 고객이 배치가 중지된 이유를 묻는 경우 시작 프로필 스냅샷, 완료된 작업 수, 실패한 작업 수 및 최종 프로필 스냅샷을 비교하십시오.

오류

프로필 오류는 공유된 API 오류 형태를 따릅니다. 향후 사용 엔드포인트가 스키마에 나타나면 동일한 재시도 및 로깅 규칙을 적용합니다. 즉, requestId를 기록하고, API 키를 기록하지 않고, 크레딧이 부족하면 일괄 생성을 일시 중지합니다.