본문으로 건너뛰기
TurnitPass
개발자API v1
API 키 만들기
문서 보기

개발자API 참조

TurnitPass REST API

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

REST API v1

참조 콘솔

경로, 페이로드, 응답 형태부터 시작하세요.

전체 참조는 아래 모든 엔드포인트를 다룹니다. 콘솔은 개발자가 먼저 필요한 계약을 보여 줍니다. Bearer 인증, JSON 입력, 계량된 출력, status 확인.

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"
}
계량됨기록됨JSON
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
검토POST /detect
StatusGET /status
POST/api/v1/humanize
v1

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

POST/api/v1/paraphrase
v1

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

POST/api/v1/rewrite
v1

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

POST/api/v1/detect
v1

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

POST/api/v1/citation
v1

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

POST/api/v1/bibliography
v1

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

GET/api/v1/status
v1

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

매개변수와 옵션

인증
Authorization: Bearer tp_your_api_key
용어 보존
선택 사항인 personal_terms 배열을 사용하면 영어 다듬기 중 고유명사, 기술 용어 및 특정 브랜드 표기를 보존할 수 있습니다.
제한사항
Humanize/rewrite: 500 quality units; paraphrase: 2,000 quality units. Detection: 5,000 word units and 30,000 characters, with a separate daily scan allowance. Citations are rate-limited and do not spend writing credits.
에러
JSON 오류 응답에는 error, code, message 필드가 구성됩니다.

속도 제한과 요청 한도

변환 입력
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
탐지 입력
최대 5,000단어더 긴 detector 스캔은 제출 전에 나눠야 합니다.
API 키
활성 키 최대 5개키는 워크스페이스에서 독립적으로 취소할 수 있습니다.
인용 도구
별도 속도 제한citation과 bibliography 호출은 단어 크레딧을 사용하지 않습니다.

오류 처리

오류 응답은 가능한 경우 error, code, 읽기 쉬운 message 필드가 있는 JSON을 사용합니다.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Stripe와 Google 자격 증명은 구성으로 남습니다. API 표면, 인증 흐름, 영속성은 이미 구현되어 라이브 자격 증명을 제품 재설계 없이 추가할 수 있습니다.

예시

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

200 OK
{
  "output": "다듬어진 결과물...",
  "words_used": 142,
  "words_remaining": 2858
}
다중 엔드포인트 예시
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..."
}

다음 단계

빠른 시작

첫 요청을 준비합니다.

인증

API 키 처리를 확인합니다.

업데이트 로그

최근 플랫폼 변경을 봅니다.

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