계정 설정 및 API 동작

계정의 일부 동작은 이 API가 아닌 웹 앱의 프로필 설정 페이지에서 한 번 구성됩니다. 이 페이지에서는 v1에서 이러한 각 설정이 어떻게 적용되는지 설명합니다. API가 이를 무조건 따르는지, 아니면 요청별로 재정의할 수 있는지도 다룹니다. 이 내용은 개별 엔드포인트 문서에 분산되지 않고 여기에 모아두었습니다. 각 엔드포인트 참조 페이지를 하나씩만 읽으면 이러한 교차 동작을 놓치기 쉽기 때문입니다.

일반 규칙

v1은 계정의 현재 구성을 직접 읽어 적용합니다. 별도의 API 계층 구성 시스템은 없으며, 단일 요청에 대해 계정 설정을 재정의할 방법도 없습니다. 이는 의도적인 설계입니다. 동일한 동작을 구성하는 두 개의 독립적인 장소를 유지하면 필연적으로 동기화가 어긋나게 됩니다. 목표는 웹 앱, 이 API, Google Sheets 애드온 등 어떤 표면에서 처리를 시작하든 동일한 계정이 동일하게 동작하도록 하는 것입니다.

설정 및 API 동작 방식

설정	웹 앱 동작	v1 API 동작	요청별 재정의 가능?
bbox 자동 주석 `auto_annotate_bbox`	계정 수준 토글입니다. 활성화되면 완료된 모든 추출에 대해 유료 bbox 주석 패스가 자동으로 실행됩니다.	정확히 따릅니다. v1을 통해 생성 및 처리된 배치는 예외 없이 이 토글을 따릅니다. 토글이 켜져 있으면 직접 `POST /documents/{document_id}/bbox`를 호출하지 않아도 bbox 주석에 대한 요금이 청구될 수 있습니다.	아니요. 요청 수준에서 건너뛰거나 강제할 방법이 없습니다.
처리 품질 `thinking_type`	처리 속도/품질 등급을 선택하는 계정 수준 설정입니다.	위 규칙의 유일한 예외입니다. `POST /batches/{batch_name}/process`에서 `quality`를 생략하면 웹 앱과 동일하게 계정의 현재 설정으로 대체됩니다. 하지만 해당 요청에 `quality: "fast"` 또는 `quality: "high"`를 전달하여 해당 호출에만 재정의할 수도 있습니다.	예 — 이 페이지에서 요청별로 재정의할 수 있는 유일한 설정입니다.
데이터 보존 `auto_delete` / `auto_delete_after`	처리 후 N일이 지나면 원본 이미지를 자동으로 삭제하는 계정 수준 설정입니다.	정확히 따릅니다. v1을 통해 생성된 문서는 웹 앱을 통해 업로드된 모든 문서와 동일한 보존 정책이 적용됩니다.	아니요.
처리 모드	웹 앱은 현재 테이블 형식 추출과 전체 문서 Word 변환을 지원합니다.	v1은 현재 `mode=table`만 지원합니다. 전체 문서 변환은 계획되어 있지만 아직 API를 통해 사용할 수 없습니다.	아직 해당되지 않습니다. 선택할 수 있는 값이 하나뿐입니다. 더 많은 모드가 출시되면 기존 값의 동작 변경이 아닌 순수한 추가 사항이 됩니다.

요청 수준 재정의를 추가하지 않는 이유는 무엇인가요?

bbox 자동 주석과 보존 정책은 호출별 기본 설정이 아닌 계정 수준의 거버넌스로 처리됩니다. 이는 '모든 항목에 켜기 또는 모든 항목에 끄기' 스위치와 같은 성격으로, 하나의 API 호출이 계정의 기존 설정에서 조용히 벗어나도록 허용하면 이 설계가 방지하려는 두 구성 소스 간의 차이 문제가 정확히 발생합니다. quality는 다릅니다. 어떤 속도/품질 계층이 적합한지는 호출마다 실제로 달라질 수 있으므로, 거버넌스 설정이 아닌 운영상의 선택으로 처리되며 유일한 재정의 항목으로 열려 있습니다.