문서 보기

TurnitPass API 개발 가이드

API 키 시작법을 배우고, 인간화, 패러프레이즈, 탐지, 인용 및 참고문헌 엔드포인트를 호출하여 자체 작성 소프트웨어에 TurnitPass를 연동하세요.

REST API v1

One request

Quick example

Bearer API 키로 humanizer 엔드포인트에 텍스트를 보냅니다. 응답에는 변환된 결과, 사용한 단어 수, 키 소유자의 남은 잔액이 포함됩니다.

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

TurnitPass는 같은 API 키 흐름으로 paraphrase, rewrite, detector, citation, bibliography, status 엔드포인트도 제공합니다.

Route map

Explore the docs

빠른 시작

워크스페이스에서 API 키를 생성한 후, 같은 키로 작성, 점검 및 인용 기능을 호출합니다.

인증

개발자 요청은 TurnitPass 워크스페이스에서 생성된 API 키를 사용합니다.

API 참조

인간화, 패러프레이즈, 탐지, 인용, 참고문헌 및 API 키 상태 엔드포인트 참조 문서.

업데이트 로그

인간화 도구, 탐지기, 작성 기능, 결제 및 API와 관련한 최신 변경 사항들을 확인하실 수 있습니다.

첫 번째 인간화 요청 보내기

키를 만들고 첫 요청을 보냅니다.

TurnitPass REST API

엔드포인트, 매개변수, 한도, 응답 형태를 확인합니다.

다음 단계

Request lifecycle

모든 TurnitPass API 호출은 같은 경로를 따릅니다. 키 인증, 페이로드 검증, 작성 또는 인용 워크플로 실행, 사용량 계량, 제품이 저장할 수 있는 응답 형태 반환.

API 키 인증

워크스페이스에서 발급한 키를 보냅니다. 취소되었거나, 형식이 잘못되었거나, 누락된 키는 텍스트 처리 전에 실패합니다.

텍스트, 언어, 한도 검증

변환 요청은 단어 범위를, detector 요청은 더 긴 스캔 한도를, citation 요청은 스타일과 출처를 검증합니다.

워크플로 실행

humanize, paraphrase, rewrite, detect, citation, bibliography 경로는 공개 도구와 같은 서버 동작을 재사용합니다.

사용량 기록 및 결과 반환

성공한 호출은 결과에 더해 사용한 단어, 남은 잔액, 상태 또는 서식 있는 인용 내보내기 같은 사용 메타데이터를 반환합니다.

API 명세

핵심 엔드포인트

인간화

POST/api/v1/humanize

텍스트 고유의 의미를 유지하면서 AI가 작성한 듯한 신호를 줄입니다.

Paraphrase

POST/api/v1/paraphrase

다양한 모드를 활용하여 텍스트를 재작성하고 세련되게 다듬습니다.

Detect

POST/api/v1/detect

탐지기 스타일의 점수, 위험 수준 및 작성 특징을 반환합니다.

Citations

POST/api/v1/citation

DOI, URL 또는 수동 소스 메타데이터를 서식에 맞춰 정리합니다.

Production checklist

서버 측 호출

클라이언트 번들에 API 키를 노출하지 마세요백엔드, worker, 큐 또는 보호된 server action에서 TurnitPass를 호출하세요.

재시도 동작

네트워크 실패만 재시도4xx는 사용자 또는 페이로드 문제로 처리하고, 일시적인 5xx/네트워크 오류에만 재시도하세요.

단어 예산

대량 흐름 전에 잔액을 표시status 엔드포인트로 작업을 대기열에 넣을지, 업그레이드를 요청할지, 문서를 나눌지 결정하세요.

결제 설정

Stripe 시크릿은 최종 구성입니다checkout, portal, webhook은 연결되어 있습니다. 라이브 키와 price ID는 배포 시 넣습니다.

제품 연동에서는 환경마다 TurnitPass 키를 하나씩 사용하세요. 프로덕션, 스테이징, 로컬 개발은 독립적으로 취소할 수 있어야 합니다.

다음으로 워크플로에 연결하세요.계속 읽기