Docs menuOverview

DocumentationQuickstart to reference

Tài liệu API

Tài liệu API TurnitPass

Bắt đầu bằng cách tạo khóa API, gọi các chức năng chỉnh sửa, diễn giải, kiểm tra AI, trích dẫn và danh mục tài liệu tham khảo để kết nối TurnitPass vào sản phẩm viết của bạn.

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

Bắt đầu nhanh

Tạo khóa API từ khu vực làm việc, sau đó gọi các chức năng viết, kiểm tra AI và trích dẫn bằng cùng một khóa.

Xác thực

Các yêu cầu phát triển sử dụng khóa API được tạo từ khu vực làm việc TurnitPass.

Tham chiếu API

Tham chiếu cho các chức năng đã xác thực dành cho chỉnh sửa, diễn giải, kiểm tra AI, trích dẫn, danh mục tài liệu tham khảo và trạng thái khóa API.

Nhật ký thay đổi

Các thay đổi gần đây của nền tảng đối với công cụ nhân hóa, phát hiện AI, công cụ viết, thanh toán và API.

Gửi yêu cầu chỉnh sửa đầu tiên của bạn

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

Chức năng cốt lõi

Chỉnh sửa

POST/api/v1/humanize

Chỉnh bản nháp có AI hỗ trợ trong khi vẫn giữ nguyên ý nghĩa.

Diễn giải

POST/api/v1/paraphrase

Viết lại và tinh chỉnh văn bản theo nhiều chế độ khác nhau.

Kiểm tra AI

POST/api/v1/detect

Trả về ước tính dấu hiệu AI và gợi ý chỉnh sửa.

Trích dẫn

POST/api/v1/citation

Định dạng siêu dữ liệu nguồn DOI, URL hoặc nhập thủ công.

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.