Docs menuOverview

DocumentationQuickstart to reference

개발자 문서

TurnitPass API 개발 가이드

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

One request

Quick example

Send text to the humanizer endpoint with a Bearer API key. The response returns the transformed output, words used, and the remaining word balance for the key owner.

curl

POST /api/v1/humanize

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

response

200 OK

{
  "output": "Your humanized text...",
  "words_used": 6,
  "words_remaining": 249994
}

TurnitPass also exposes paraphrase, rewrite, detector, citation, bibliography, and status endpoints from the same API-key flow.

Route map

Explore the docs

빠른 시작

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

인증

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

API 참조

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

업데이트 로그

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

첫 번째 인간화 요청 보내기

Create a key and make the first request.

TurnitPass REST API

Review endpoints, parameters, limits, and response shapes.

Production flow

Request lifecycle

Every TurnitPass API call follows the same product path: authenticate the key, validate the payload, run the writing or citation workflow, meter usage, and return a response shape that can be stored by your product.

Authenticate the API key

Send an API key generated from the workspace. Revoked, malformed, or missing keys fail before text processing starts.

Validate text, language, and limits

Transform requests enforce word ranges, detector requests enforce longer scan limits, and citation requests validate style and source input.

Run the workflow

Humanize, paraphrase, rewrite, detect, citation, and bibliography routes reuse the same server-side behavior as the public tools.

Record usage and return output

Successful calls return output plus usage metadata such as words used, remaining balance, status details, or formatted citation exports.

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

Server-side calls

Never expose API keys in client bundlesCall TurnitPass from your backend, worker, queue, or protected server action.

Retry behavior

Retry network failures, not validation failuresHandle 4xx responses as user or payload issues and reserve retries for transient 5xx/network errors.

Word budgets

Show remaining balance before heavy flowsUse the status endpoint to decide whether to queue a job, ask for upgrade, or split a document.

Billing setup

Stripe secrets are final configurationThe checkout, portal, and webhook surfaces are wired; live keys and price IDs are intentionally left for deployment.

For product integrations, keep one TurnitPass key per environment. Production, staging, and local development should be revocable independently.