Bỏ qua đến nội dung
TurnitPass
Nhà phát triểnAPI v1
Tạo khóa API
Xem tài liệu

Nhà phát triểnTham 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.

REST API v1

Bảng tham chiếu

Bắt đầu với route, payload và dạng phản hồi.

Tài liệu tham chiếu đầy đủ phủ mọi endpoint bên dưới. Bảng điều khiển hiện hợp đồng mà nhà phát triển cần trước: auth Bearer, đầu vào JSON, đầu ra đo mức dùng và kiểm tra 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"
}
đo mức dùngđã ghiJSON
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
Kiểm traPOST /detect
StatusGET /status
POST/api/v1/humanize
v1

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
v1

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
v1

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
v1

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
v1

Đị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
v1

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
v1

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

Tham số và tùy chọn

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.

Giới hạn tốc độ và giới hạn yêu cầu

Đầu vào chuyển đổi
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Đầu vào phát hiện
Tối đa 5.000 từBản quét detector dài hơn nên được tách trước khi gửi.
Khóa API
Tối đa 5 khóa đang hoạt độngCó thể thu hồi từng khóa độc lập từ khu vực làm việc.
Công cụ trích dẫn
Giới hạn tốc độ riêngLời gọi citation và bibliography không trừ tín dụng từ.

Xử lý lỗi

Phản hồi lỗi dùng JSON với các trường error, code và message dễ đọc khi có thể.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Thông tin Stripe và Google vẫn là cấu hình. Bề mặt API, luồng auth và lưu trữ đã được triển khai để thêm thông tin live mà không cần thiết kế lại sản phẩm.

Ví dụ

Ví dụ humanize
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
}
Ví dụ nhiều endpoint
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..."
}

Bước tiếp theo

Bắt đầu nhanh

Thiết lập yêu cầu đầu tiên.

Xác thực

Xem cách xử lý khóa API.

Nhật ký thay đổi

Xem thay đổi nền tảng gần đây.

Tiếp theo, gắn vào quy trình của bạn.Đọc tiếp