문서 보기
API 키로 인증하기
개발자 요청은 TurnitPass 워크스페이스에서 생성된 API 키를 사용합니다.
Auth console
API 키를 브라우저에 두지 마세요.
TurnitPass API 호출은 워크스페이스 소유의 Bearer 키를 사용합니다. 키는 서버 전용 코드에 두고, 생성·교체·취소·사용량 확인은 대시보드에서 합니다.
키 가드레일
접근을 안전하게 유지하는 방법
서버만
백엔드 라우트, worker, 작업 또는 보안 server action에서 키를 보내세요.
한 번만 표시
생성된 키를 즉시 복사해 시크릿 관리자에 저장하세요.
안전하게 교체
기존 프로덕션 키를 취소하기 전에 대체 키를 배포하세요.
계정 범위
사용량은 워크스페이스 단어 잔액과 결제 제어로 집계됩니다.
Bearer 요청
헤더 계약
fetch('https://turnitpass.com/api/v1/humanize', {
method: 'POST',
headers: {
Authorization: 'Bearer tp_live_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: draft, language: 'en' })
})
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}
API 키
모든 요청에 API 키를 포함하세요. 키는 생성 시점에 한 번만 표시되며 작업 공간에서 언제든 취소할 수 있습니다.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
생성
워크스페이스에서 이름이 있는 키를 만들고 바로 복사하세요.
취소
키를 즉시 비활성화합니다. 취소된 키는 새 요청에 사용할 수 없습니다.
속도 제한
각 키는 독립적으로 제한할 수 있고, 사용량은 계정으로 집계됩니다.
결제
모든 키는 계정의 단어 잔액과 구독 한도를 공유합니다.
워크스페이스 소유
Key lifecycle
이름이 있는 키 만들기
환경이나 앱 표면을 설명하는 이름을 쓰세요. 예: Production backend, Staging worker, Internal QA.
한 번만 복사해 시크릿 저장소에 넣기
TurnitPass는 생성 시에만 키를 표시합니다. 배포 공급자, CI 시크릿 관리자 또는 로컬 .env 파일에 저장하세요.
status와 결제로 사용량 확인
모든 키가 단어 잔액을 공유합니다. 키 이름으로 어떤 연동이 활성인지 찾기 쉽습니다.
취소 전에 교체
대체 키를 만들고 배포한 뒤 트래픽이 정상인지 확인한 다음, 워크스페이스에서 이전 키를 취소하세요.
Environment setup
TurnitPass 키는 서버 전용 시크릿으로 저장하세요. 아래 예시는 Next.js, Workers, 서버 작업 또는 모든 백엔드 런타임에 맞는 일반 이름을 사용합니다.
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Security best practices
Authentication errors
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}