API 참조용법
용법
해외 통합을 위한 계정 사용량, 크레딧, 할당량을 확인하세요.
용법
해외통합의 경우 금일 안정계좌 확인은 프로필 입니다. 대규모 작업 전에 크레딧, 계층 및 남은 API 할당량을 읽는 데 사용합니다. 전용 사용 엔드포인트는 스키마 기반: GET /api/openapi.json에 있는 호출 전용 경로로 처리되어야 합니다.
요구
프로필은 일반적인 전달자 인증 요청을 사용합니다.
GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEYcurl 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 키를 기록하지 않고, 크레딧이 부족하면 일괄 생성을 일시 중지합니다.