계정
API 키 소유 계정에 대한 두 개의 읽기 전용 엔드포인트입니다. 플랜 및 사용 가능 크레딧( SDK가 자체적으로 제한해야 하는 두 가지 수치)에 대한 스냅샷과 셀프 서비스 정산을 위한 페이지별 크레딧 소비 내역을 제공합니다.
계정 가져오기
계정의 유효 플랜과 크레딧을 반환합니다. 계정이 팀의 구성원인 경우, 개인의 멤버십 플랜이 아닌 팀 소유자의 플랜/크레딧 풀이 이미 반영됩니다.
매개변수
없음 — 계정은 Authorization 헤더의 API 키로 완전히 결정됩니다.
max_batch_size 및 upload_concurrency는 클라이언트 SDK가 먼저 invalid_parameter/rate_limit_exceeded 오류를 통해 이러한 제한을 발견하는 대신 자체 업로드 루프를 자체적으로 제한할 수 있도록 제공됩니다.
가능한 오류
missing_api_key/invalid_api_key/plan_required— 오류 처리를 참조하세요.
계정 사용량 조회
계정의 모든 크레딧 영향 이벤트를 최신순으로 페이지네이션하여 보여주는 원장입니다 — 추출 차감, bbox 주석 차감, 환불이 포함됩니다. "이 작업에 크레딧이 얼마나 들었나"를 확인하는 용도로 설계되었으며, UI 구동용이 아닙니다(/profile/usage_history의 사전 형식화된 표시 문자열과 비교 — 이 엔드포인트는 해당 문자열을 반환하지 않으며, 구조화된 부호 있는 amount 값을 대신 제공합니다).
매개변수
| 이름 | 위치 | 유형 | 설명 |
|---|---|---|---|
limit | query, 선택 사항 | integer | 1–200. 기본값 50. |
batch_name | query, 선택 사항 | string | 원장을 특정 배치의 항목으로 제한합니다 — "배치 X에 크레딧이 얼마나 들었나"를 확인하는 용도입니다. |
page_token | query, 선택 사항 | string | 이전 응답의 next_page_token에서 가져온 불투명 커서입니다. 이 엔드포인트는 최신순으로 페이지네이션합니다(다른 v1 목록 엔드포인트는 오래된 순으로 페이지네이션함) — 토큰은 여전히 불투명하며 동일한 방식으로 왕복되지만, 기본 순서만 다릅니다. 페이지네이션을 참조하세요. |
amount는 부호가 있습니다: 지출(추출/bbox 차감)은 음수, 크레딧 반환(환불/취소 환불)은 양수입니다 — 따라서 한 페이지의 amount 값을 합산하면 해당 페이지의 순 변화량을 알 수 있습니다. document_id는 문서의 document_id와 동일한 ID 공간입니다(내부 원장에서는 task_id라고 부르며, 이 엔드포인트는 v1의 나머지 부분과 일관성을 위해 이름을 변경합니다).
차감 금액의 크기가 항상 1인 것은 아닙니다. 모든 계정에는 모델 티어가 있습니다 — Standard(기본값), Advanced, Premium — 이 티어가 어떤 AI 모델로 추출을 실행할지, 그리고 처리된 각 문서에 크레딧이 얼마나 소요되는지 결정합니다: Standard는 1, Advanced는 3, Premium은 6입니다. API 호출별로 설정할 수 있는 방법은 없으며, ImageToTable.ai 팀이 계정에 할당합니다. 계정이 Standard가 아닌 경우 action 필드에 기본 이름 대신 티어 접미사가 포함됩니다 — deduction_advanced, deduction_premium — 따라서 amount를 직접 확인하지 않고도 비Standard 요금을 식별할 수 있습니다. 환불은 이후 티어 변경의 영향을 받지 않습니다: 작업은 처리 시작 시 실제로 청구된 티어 기준으로 항상 환불되며, 환불이 실행될 때 계정이 속한 티어와는 무관합니다. 따라서 refund 행의 크기는 항상 해당 행이 상쇄하는 deduction/deduction_<tier> 행과 일치합니다. v1이 읽는 다른 모든 계정 수준 설정과의 상호 작용에 대해서는 계정 설정 및 API 동작을 참조하세요.
가능한 오류
missing_api_key/invalid_api_key/plan_required— 오류 처리를 참조하세요.invalid_parameter—limit또는page_token이 잘못되었습니다.