AI Humanizer API
단일 REST 호출로 자사 제품 안에서 AI 텍스트를 인간화하세요. AI humanizer API는 TextPulse를 구동하는 엔진을 백엔드에 제공합니다. JSON을 보내면 재작성된 산문이 돌아오며, 60개 이상의 언어를 지원합니다.
첫 요청 만들기
Authorization: Bearer 헤더로 인증한 뒤 텍스트를 전송하세요. 재작성된 버전은 해당 호출의 계량 정보와 함께 outputText로 반환됩니다.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}AI humanizer API란 무엇인가?
AI humanizer API는 다른 제품 내부에서 기계 생성 텍스트를 자연스럽고 사람처럼 들리는 산문으로 다시 쓰는 REST 엔드포인트입니다. 텍스트를 웹 앱에 붙여 넣는 대신, 백엔드가 이를 JSON으로 전송하고 응답에서 다시 작성된 버전을 받으므로, humanization은 편집기의 버튼, 문서 파이프라인의 한 단계, 콘텐츠 라이브러리 전체에 대한 배치 작업처럼 자체 소프트웨어의 기능이 됩니다.
TextPulse humanizer API는 TextPulse 대시보드를 구동하는 것과 동일한 엔진을 제공합니다. 이 엔진은 20개가 넘는 언어적 신호를 동시에 활용하여 문장 길이와 구조를 변화시키고, 언어 모델이 과도하게 선택하는 어휘를 대체하면서, 본문 인용, 참고문헌 항목, 통계, 고정 용어는 그대로 통과시킵니다. 2,000개 문서로 구성된 학술 코퍼스에서 humanized 출력은 Turnitin AI를 92.33%의 경우에, Originality.ai를 89.12%의 경우에, GPTZero를 87.91%의 경우에 통과했습니다. 이러한 학술 수준의 동작이 일반적인 패러프레이즈 엔드포인트와 구별되는 점입니다. 사용자가 돌려받는 텍스트는 단순히 다른 것이 아니라, 출판 가능한 수준입니다.
AI humanizer API가 대신 처리하는 것
언어 라우팅, 문체 제어, 계량, 재시도 안전성은 엔드포인트에 포함되어 있어 통합이 단일 함수로 유지됩니다.
하나의 경로로 60개 이상 언어 지원
영어는 미세 조정된 humanizer 엔진에서 처리됩니다. language 값을 전달하면 요청은 대신 다국어 경로로 라우팅되므로, 영어가 아닌 제품 페이지도 별도 통합 없이 같은 엔드포인트를 사용할 수 있습니다.
문체와 강도는 매개변수입니다
5개 문체 모드는 Academic, Corporate, Creative, Blog/SEO, General 문체를 포괄합니다. intensityScalar 값은 재작성 결과가 원문과 얼마나 달라질지를 정하며, 0, 0.25, 0.5, 0.75, 1 중 하나를 사용합니다. Mild에서 시작해 0.5의 Balanced 기본값을 거쳐 Aggressive까지 이어집니다.
문서당 POST 1회
폴링할 작업 큐도, 등록할 웹훅도 없습니다. humanize 호출은 모델이 반환할 때까지 연결을 유지한 뒤 재작성된 텍스트로 응답하므로, 단일 요청으로 작업이 완료됩니다.
재시도는 중복 과금되지 않음
requestId를 보내면 결과가 약 10분 동안 그 값에 대해 캐시됩니다. 같은 식별자를 그 시간 안에 다시 보내면 모델을 다시 실행하지 않고 저장된 응답을 재생하며, 엔진이 완료하지 못한 요청은 사용한 단어 수가 자동으로 잔액에 복원됩니다.
엔드포인트 참조
Authorization: Bearer 헤더에서 키를 읽습니다. 키는 tp_live_로 시작하며 프로젝트별로 발급됩니다./api/v1/humanize/api/v1/balance단일 humanize 호출은 10,000자 한도 내에서 최대 1,000단어를 허용하며, 각 키는 분당 60개 요청을 발급할 수 있습니다. 더 긴 문서는 일련의 호출로 전송됩니다.
요청 매개변수
text만 필요합니다. 그 밖의 항목은 모두 합리적인 기본값을 가지므로, 최소 통합은 하나의 필드만으로 가능합니다.
| 매개변수 | Type | 필수 여부 | 비고 |
|---|---|---|---|
text | string | 필수 | humanize할 텍스트입니다. 요청당 10,000자 한도 내에서 최대 1,000단어까지 가능합니다. |
writingMode | string | 기본값: Academic | Academic, Corporate, Creative, Blog/SEO, General 중 하나입니다. 다시 쓰기의 문체를 설정합니다. |
intensityScalar | number | 기본값: 0.5 | 0, 0.25, 0.5, 0.75, 1 중 하나입니다. 다시 쓰기가 원문에서 얼마나 멀어질지, Mild에서 Balanced를 거쳐 Aggressive까지의 정도를 정합니다. |
language | string | 선택 사항 | 영어가 아닌 텍스트를 다국어 경로로 보냅니다. 세밀하게 조정된 영어 엔진을 사용하려면 생략하거나 영어를 보내십시오. |
englishVariant | string | 선택 사항 | American 또는 British입니다. 철자와 어휘를 대서양의 한쪽에 맞춥니다. |
freezeTerms | string[] | 선택 사항 | 다시 쓰기 과정에서 그대로 통과할 최대 10개의 용어나 구문입니다. 예: 구조물 이름, 기기, 제품명. |
removeEmDashes | boolean | 선택 사항 | em dash 구조를 일반적인 문장 부호로 다시 씁니다. |
requestId | string | 권장 | 멱등성 토큰입니다. 약 10분 이내에 같은 값을 반복하면 다시 과금하지 않고 저장된 응답을 재생합니다. |
응답 필드
outputTexthumanized된 텍스트입니다.metrics.inputWords / outputWords수신된 단어 수와 반환된 단어 수입니다. 다시 쓰기 결과는 원문보다 약간 더 길어지는 경우가 많습니다.metrics.wordsCharged이 호출의 비용입니다. 항상 입력 단어 수와 같고, 출력 단어 수와는 같지 않습니다.metrics.balanceRemaining이 호출 이후 키에 남은 단어 크레딧입니다. 별도의 요청 없이도 사용량을 측정할 수 있습니다.metrics.modelLatencyMs / route다시 쓰기에 걸린 엔진 시간과 이를 처리한 경로입니다.오류와 재시도
모든 오류는 안정적인 error.code와 사람이 읽을 수 있는 메시지를 JSON으로 반환합니다. 설계할 때 기억할 규칙은 다음과 같습니다. 실제로 전달된 다시 쓰기에 대해서만 과금되며, 같은 requestId로 재시도하는 것은 항상 안전합니다.
UNAUTHORIZEDAPI 키가 없거나 인식되지 않습니다. Authorization: Bearer 헤더를 확인하십시오.INSUFFICIENT_BALANCE키에 단어 크레딧이 충분하지 않습니다. 응답에는 사용 가능한 잔액이 포함됩니다.REQUEST_IN_PROGRESS이 requestId를 가진 요청이 아직 처리 중입니다. 경쟁시키지 말고 기다리십시오.TOO_LONG / VALIDATION_FAILED입력이 1,000단어 한도를 초과했거나 매개변수 형식이 잘못되었습니다. 응답에는 정확한 문제가 나열됩니다.ENGINE_ERROR엔진이 실패했거나 시간 초과되었습니다. 단어는 이미 잔액에 반환되었으므로, 같은 requestId로 다시 시도하십시오.엔드포인트를 구동하는 엔진
모든 호출은 공개된 TextPulse 엔진으로 실행되며, 2,000개 문서로 이루어진 학술 코퍼스에서 측정되고 탐지 모델이 업데이트될 때마다 다시 실행됩니다. 탐지기별 통과율:
공급업체가 측정한 수치로, 각자의 코퍼스와 함께 공개됩니다. 어떤 humanizer도 특정 문서에서의 탐지기 결과를 약속할 수 없으므로, 제품 메시지는 보장이 아니라 측정값에 기반해야 합니다.
팀이 humanizer API 위에 구축하는 것
EdTech 및 글쓰기 플랫폼
기존 문법 또는 패러프레이즈 기능 옆에 humanize 작업을 추가하세요. Academic 모드는 인용을 그대로 유지하므로, 학생용 도구는 텍스트를 전송하기 전에 참고문헌을 제거할 필요가 없습니다.
문서 및 교정 도구
전체 문서를 1,000단어 단위로 나누어 처리한 뒤 다시 조립하세요. freeze terms는 청크 간 이름과 용어를 안정적으로 유지하고, idempotent retries는 배치 파이프라인을 안전하게 다시 실행할 수 있게 합니다.
콘텐츠 및 SEO 제품
Blog/SEO 모드는 초안을 게시 가능한 문장으로 다시 작성하며, freeze terms는 대상 키워드를 고정하므로 문안은 검색 의도를 유지하고 기계적인 리듬은 잃게 됩니다.
화이트라벨 파트너
이 엔드포인트는 귀사 제품 내부에서 보이지 않게 실행됩니다. 귀사의 인터페이스, 귀사의 청구, 우리의 엔진입니다. 파트너 계약은 액세스 양식을 통해 월간 사용량 기준으로 견적됩니다.
AI humanizer API 요금
크레딧은 선불이며 단어 수 기준으로 차감됩니다. 과금은 엔진이 반환한 결과가 아니라 전송한 분량을 기준으로 하며, 재작성을 생성하지 못한 호출은 키에 다시 적립됩니다.
크레딧은 구매 후 12개월 동안 유효하며, 엔드포인트가 지원하는 모든 언어, 작성 모드, 영어 변형을 포함합니다. 지속적인 대량 사용이나 자체 제품 내 화이트 라벨 방식의 도입을 원하시면, 접근을 요청해 주시면 월간 사용량 기준으로 견적을 드립니다.
AI humanizer API 질문
API 키 받기
키는 프로젝트별로 발급됩니다. 무엇을 만들고 있는지 설명해 주시면 24시간 이내에 답변드리겠습니다.