1상태·목록 조회
/rest/subagent/v1/status요청 파라미터 없음
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
응답 필드
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
조사·추출·요약·비교를 위임하고, 원문 인용과 해시로 검수합니다.
각 프로젝트에 전달할 연동 지침에서 복사해 사용하는 지시문, 연결 코드로 인증키 연결, 첫 확인(목록 작업 1P), 프로젝트별 파일 범위, 실제 위임·근거 검수와 오류 대응을 확인하세요. 지침 파일 내려받기
Node.js 22.17 이상에서 설치합니다. Codex·Claude Code 설정의 기존 항목은 보존합니다.
npm install -g apick-subagent
apick-subagent install
# 마이페이지 › API 정보에서 연결 코드를 발급해 붙여 넣은 뒤 클라이언트 재시작
apick-subagent login
apick-subagent doctor프로젝트 폴더를 열고 “이 자료의 비교를 apick-subagent에 위임하고 핵심 근거를 검수해 줘”라고 요청하세요. 설치만으로 모든 요청의 위임이 강제되지는 않습니다. 작업에 맞는 위임 여부는 주 에이전트가 판단합니다.
배포 파일로 직접 설치할 수도 있습니다: npm install -g https://apick.app/downloads/apick-subagent-1.0.5.tgz
모든 요청에 Authorization: Bearer API_KEY가 필요합니다. 접수에는 Idempotency-Key를 보내세요. 같은 키와 같은 내용은 기존 작업을 반환하며, 다른 내용은 409 오류입니다. 연결 종료는 작업 취소가 아닙니다.
curl https://apick.app/rest/subagent/v1/status \
-H "Authorization: Bearer $APICK_API_KEY"
curl -X POST https://apick.app/rest/subagent/v1/jobs \
-H "Authorization: Bearer $APICK_API_KEY" \
-H "Idempotency-Key: project-review-20261004-001" \
-H "Content-Type: application/json" \
-d '{"kind":"compare","goal":"문서 두 개의 차이와 충돌을 비교하세요","file_ids":["업로드 완료한 파일 ID"],"focus":[],"acceptance":["모든 주장에 원문 근거"],"retention":"seven_days"}'kind는 inventory(목록), extract(추출), summarize(요약), compare(비교) 중 하나입니다. 파일 수·토큰·누적 사용액의 상품 한도는 없습니다. 파일은 part_bytes 크기로 나눠 올리고, 결과가 길면 cursor로 다음 부분을 조회합니다.
원격 주소는 https://apick.app/mcp/subagent입니다. Bearer 인증을 지원하는 Streamable HTTP 클라이언트에서 연결하세요. 원격 MCP는 이미 업로드한 자료로 작업합니다. 내 컴퓨터의 파일을 올리는 일은 설치 패키지가 합니다.
설치비·도입비·구독료는 없고, 성공한 작업의 실제 사용량에 따라 정산합니다. 성공한 작업은 최소 1P, AI를 사용한 작업은 작업당 기본요금 5P가 최소액입니다. 승인된 동일 결과 캐시 재사용은 1P입니다. 접수 시 예상 최대 비용을 예약하고 차액을 해제합니다. 실패·취소·자동 검증 실패는 청구하지 않습니다. 비용 미확정이 24시간 지속되면 예약을 해제합니다.
자료는 7일 후 만료됩니다. retention을 none으로 보내면 검수 완료 후 삭제하며, 임시 보관은 최대 1시간입니다. 즉시 삭제도 가능합니다.
요약은 목표와 관련된 원문 인용을 자료(파일)별로 묶습니다. 비교는 동일 문구와 자료별 고유 문구를 구분합니다. 자동 근거 검증은 인용·행·해시 일치 검사이며 의미 판단과 최종 결론은 주 에이전트가 검수합니다.
/rest/subagent/v1/status추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/jobs추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/files추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/files/:file_id/parts경로의 file_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_FILE_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/files/:file_id/complete경로의 file_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_FILE_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/jobs/:job_id경로의 job_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_JOB_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/jobs/:job_id/evidence경로의 job_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_JOB_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/jobs/:job_id/review경로의 job_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_JOB_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/jobs/:job_id/cancel경로의 job_id는 앞 단계에서 받은 값으로 바꾸세요. 예제는 APICK_JOB_ID 환경변수에서 읽습니다.
추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/subagent/v1/usage추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.