문서 보기
제품에 인간화 기능 연동하기
TurnitPass 개발자 허브는 글쓰기 제품에 필요한 API 문서, 인증, 키 관리, 사용 한도와 엔드포인트 참고 문서를 제공합니다.
필요한 워크플로부터 시작
개발자 허브
연동 경로
키를 만들고, 엔드포인트를 호출하고, 사용량을 확인하세요.
개발자 경로는 제품과 같습니다. 계정 소유의 키, 측정된 요청, 보이는 단어 잔액, 실제 라우트에 맞는 문서.
API 키 만들기
작업 공간에서 이름이 있는 키를 만들고 한 번만 복사합니다.
Bearer 요청 보내기
humanizer, detector, paraphrase, citation 또는 bibliography를 호출합니다.
사용량 확인
요청은 단어 잔액, 엔드포인트 기록, 결제 한도에 모입니다.
/humanizePOST/paraphrasePOST/detectPOST/citationcurl -X POST /api/v1/humanize
-H "Authorization: Bearer $KEY"
200 OK
응답
142
사용한 단어
2,858
남은 양
작업 공간
기본 비공개
키는 해시되어 계정에 귀속됩니다.
API 명세
핵심 엔드포인트
인증 필요
Bearer API 키
사용량 측정
단어 잔액
제품 준비
결제 훅
인간화
/api/v1/humanize텍스트 고유의 의미를 유지하면서 AI가 작성한 듯한 신호를 줄입니다.
Paraphrase
/api/v1/paraphrase다양한 모드를 활용하여 텍스트를 재작성하고 세련되게 다듬습니다.
Detect
/api/v1/detect탐지기 스타일의 점수, 위험 수준 및 작성 특징을 반환합니다.
Citations
/api/v1/citationDOI, URL 또는 수동 소스 메타데이터를 서식에 맞춰 정리합니다.
활용 사례
흔한 연동
API는 브라우저에서 작성자가 쓰는 흐름과 같습니다. humanize, detect, rewrite, paraphrase, cite, 사용량 추적.
POST /api/v1/humanize콘텐츠 플랫폼
게시 전에 AI 초고를 자연화하고, 편집기에서 검출과 인용 정리를 보여 줍니다.
POST /api/v1/paraphrase글쓰기 도구
기존 문서 흐름에 paraphrase, rewrite, AIGC 검출을 넣고 모델 계층은 직접 운영하지 않습니다.
POST /api/v1/detect검토 작업 공간
제출물을 detector로 보내고 메모를 저장하며 검토자에게 신호를 보여 줍니다.
POST /api/v1/citation연구 워크플로
출처가 많은 제품과 학술 도우미를 위해 인용과 참고문헌을 형식화합니다.
운영 세부
한도, 결제, 안정성
실제 사용자에게 TurnitPass를 열기 전에 클라이언트 앱이 맞춰야 할 운영 규칙입니다.
인증
Bearer API 키
키는 만들 때 한 번만 보이며 Google 로그인을 바꾸지 않고 취소할 수 있습니다.
변환 한도
요청당 1,000단어
humanize, paraphrase, rewrite가 한도를 공유하고 성공 요청만 잔액에서 차감합니다.
검출 한도
요청당 5,000단어
검출은 더 긴 입력을 받고 추정, 메모, 신호를 반환합니다.
속도 제한
키당 분당 50회
변환·검출·status는 키당 분당 50회, citation은 100회.
결제
Stripe 준비
checkout, 포털, webhook, 잔액, 플랜 한도는 연결되어 있으며 라이브 키는 따로 설정합니다.
실패 처리
성공 시에만 차감
단어는 엔진 성공 응답 후 차감됩니다. 검증 실패는 단어를 쓰지 않습니다.
운영 참고
출시 전
출시 점검
테스트 키 만들기
작업 공간에서 API 키를 만들고 접두사가 한 번만 나타나는지 확인합니다.
핵심 호출 실행
같은 Bearer 토큰으로 humanize, detect, paraphrase, citation, bibliography, status를 호출합니다.
오류 처리
클라이언트에서 invalid_api_key, rate_limited, insufficient_words, 검증 오류를 매핑합니다.
결제 설정
플랜과 checkout 문구가 정해지면 Stripe 시크릿과 price ID를 넣습니다.