Docs menuAPI 참조

API ReferenceTyped request and response

API 참조

TurnitPass REST API

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

Reference console

Start with the route, payload, and response shape.

The full reference covers every endpoint below. The console shows the contract developers need first: Bearer auth, JSON input, metered output, and status checks.

request

POST

fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})

response

200 OK

{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}

meteredloggedJSON

POST/api/v1/humanize

POST/api/v1/paraphrase

POST/api/v1/rewrite

POST/api/v1/detect

POST/api/v1/citation

AuthBearer API key

TransformPOST /humanize

ReviewPOST /detect

StatusGET /status

POST/api/v1/humanize

제출된 텍스트를 다듬어 AI가 작성한 듯한 문체 신호를 줄입니다. 모드: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

표준, 유창성, 격식, 학술, 단순, 창의, 확장 또는 축소 모드로 텍스트를 재작성하고 다듬습니다.

POST/api/v1/rewrite

더 깨끗한 문장 구조, 톤, 문맥 흐름을 완성하기 위한 학술형 교정 기능.

POST/api/v1/detect

붙여넣은 텍스트 또는 문서에서 추출된 내용의 AI 유사 신호 추정치, 메타데이터 및 검토 메모를 반환합니다.

POST/api/v1/citation

DOI, URL 또는 수동 입력 항목을 APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA 또는 Bluebook 스타일에 맞게 가공합니다. 응답에는 HTML, 텍스트, BibTeX 및 RIS가 포함됩니다.

POST/api/v1/bibliography

요청한 스타일에 맞게 참고문헌 목록을 정렬하고 생성합니다. HTML/텍스트 출력과 BibTeX 및 RIS 파일 내보내기를 지원합니다.

GET/api/v1/status

API 키 라벨, 남은 단어 수, 요청 제한을 확인합니다.

Parameters and options

인증

Authorization: Bearer tp_your_api_key

용어 보존

선택 사항인 personal_terms 배열을 사용하면 영어 다듬기 중 고유명사, 기술 용어 및 특정 브랜드 표기를 보존할 수 있습니다.

제한사항

변환 관련 엔드포인트는 한 번에 최대 1,000단어까지 허용됩니다. 탐지는 최대 5,000단어까지 가능합니다. 인용 관련 API는 속도 제한이 적용되나 단어 한도를 차감하지 않습니다.

에러

JSON 오류 응답에는 error, code, message 필드가 구성됩니다.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "다듬고 싶은 AI 보조 초안을 붙여넣으세요",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["고유명사"]
}

200 OK
{
  "output": "다듬어진 결과물...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "다듬고자 하는 글 초안을 붙여넣으세요",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "점검하고 싶은 초안을 붙여넣으세요",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "생성된 인용구...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

빠른 시작

Set up the first request.

인증

Review API key handling.

업데이트 로그

See recent platform changes.

fetch('/api/v1/humanize', { method: 'POST', headers: { Authorization: 'Bearer tp_live_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Paste the draft here', language: 'en', mode: 'reduce-aigc' }) })

Parameters and options

인증

Authorization: Bearer tp_your_api_key

용어 보존

선택 사항인 personal_terms 배열을 사용하면 영어 다듬기 중 고유명사, 기술 용어 및 특정 브랜드 표기를 보존할 수 있습니다.

제한사항

에러

JSON 오류 응답에는 error, code, message 필드가 구성됩니다.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "다듬고 싶은 AI 보조 초안을 붙여넣으세요",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["고유명사"]
}

200 OK
{
  "output": "다듬어진 결과물...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "다듬고자 하는 글 초안을 붙여넣으세요",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "점검하고 싶은 초안을 붙여넣으세요",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "생성된 인용구...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}