Docs menuTham chiếu API

API ReferenceTyped request and response

Tham chiếu API

TurnitPass REST 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.

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

Chỉnh sửa văn bản được gửi và giảm dấu hiệu giống AI. Chế độ: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Viết lại và tinh chỉnh văn bản với các chế độ tiêu chuẩn, trôi chảy, trang trọng, học thuật, đơn giản, sáng tạo, mở rộng hoặc rút ngắn.

POST/api/v1/rewrite

Chức năng tinh chỉnh học thuật giúp cấu trúc sạch hơn, giọng văn trôi chảy và mạch lạc hơn.

POST/api/v1/detect

Trả về ước tính dấu hiệu AI, siêu dữ liệu và gợi ý chỉnh sửa đối với văn bản được dán hoặc tài liệu được trích xuất.

POST/api/v1/citation

Định dạng mã DOI, URL hoặc trích dẫn thủ công theo phong cách APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA hoặc Bluebook. Câu trả lời bao gồm HTML, văn bản, BibTeX và RIS.

POST/api/v1/bibliography

Sắp xếp và định dạng danh sách trích dẫn theo phong cách được yêu cầu, với đầu ra HTML/văn bản kèm theo xuất bản dạng BibTeX và RIS.

GET/api/v1/status

Kiểm tra nhãn khóa, số dư từ còn lại và giới hạn yêu cầu.

Parameters and options

Xác thực

Authorization: Bearer tp_your_api_key

Từ cần giữ

Mảng personal_terms tùy chọn giúp giữ tên riêng, thuật ngữ kỹ thuật và thương hiệu khi nhân hóa tiếng Anh.

Giới hạn

Các chức năng chỉnh sửa chấp nhận tối đa 1.000 từ đầu vào. Kiểm tra AI chấp nhận tối đa 5.000 từ. Trích dẫn có giới hạn riêng và không tiêu tốn số dư từ.

Errors

Phản hồi dạng JSON bao gồm các trường error, code và 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": "Dán bản nháp có AI hỗ trợ mà bạn muốn chỉnh sửa",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Tên riêng"]
}

200 OK
{
  "output": "Văn bản đã chỉnh sửa...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Dán bản nháp bạn muốn viết lại",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Dán bản nháp bạn muốn kiểm tra",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "Trích dẫn được định dạng...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

Bắt đầu nhanh

Set up the first request.

Xác thực

Review API key handling.

Nhật ký thay đổi

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

Xác thực

Authorization: Bearer tp_your_api_key

Từ cần giữ

Mảng personal_terms tùy chọn giúp giữ tên riêng, thuật ngữ kỹ thuật và thương hiệu khi nhân hóa tiếng Anh.

Giới hạn

Errors

Phản hồi dạng JSON bao gồm các trường error, code và 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": "Dán bản nháp có AI hỗ trợ mà bạn muốn chỉnh sửa",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Tên riêng"]
}

200 OK
{
  "output": "Văn bản đã chỉnh sửa...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Dán bản nháp bạn muốn viết lại",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Dán bản nháp bạn muốn kiểm tra",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "Trích dẫn được định dạng...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}