Xem tài liệu

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.

REST API v1

One request

Quick example

Gửi văn bản tới endpoint humanizer kèm khóa API Bearer. Phản hồi trả về kết quả đã chuyển đổi, số từ đã dùng và số từ còn lại của chủ khóa.

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

TurnitPass cũng cung cấp các endpoint paraphrase, rewrite, detector, citation, bibliography và status trên cùng luồng khóa API.

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

Tạo khóa và gửi yêu cầu đầu tiên.

TurnitPass REST API

Xem endpoint, tham số, giới hạn và dạng phản hồi.

Bước tiếp theo

Request lifecycle

Mọi lời gọi API TurnitPass đi cùng một đường: xác thực khóa, kiểm tra payload, chạy quy trình viết hoặc trích dẫn, đo mức dùng, rồi trả về dạng phản hồi mà sản phẩm có thể lưu.

Xác thực khóa API

Gửi khóa được tạo từ khu vực làm việc. Khóa đã thu hồi, sai định dạng hoặc thiếu sẽ thất bại trước khi xử lý văn bản.

Kiểm tra văn bản, ngôn ngữ và giới hạn

Yêu cầu chuyển đổi áp dụng khoảng số từ, detector áp dụng giới hạn quét dài hơn, citation kiểm tra kiểu và nguồn.

Chạy quy trình

Các route humanize, paraphrase, rewrite, detect, citation và bibliography dùng cùng hành vi phía máy chủ như công cụ công khai.

Ghi nhận mức dùng và trả kết quả

Lời gọi thành công trả về kết quả kèm siêu dữ liệu mức dùng: số từ đã dùng, số dư còn lại, trạng thái hoặc bản xuất trích dẫn đã định dạng.

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

Gọi từ máy chủ

Không bao giờ lộ khóa API trong gói clientGọi TurnitPass từ backend, worker, hàng đợi hoặc server action được bảo vệ.

Hành vi thử lại

Chỉ thử lại lỗi mạng, không thử lại lỗi kiểm traXử lý 4xx như vấn đề người dùng hoặc payload; chỉ thử lại lỗi 5xx hoặc mạng tạm thời.

Ngân sách từ

Hiện số dư trước các luồng nặngDùng endpoint status để quyết định xếp hàng, đề nghị nâng cấp hoặc tách tài liệu.

Thanh toán

Secret Stripe là cấu hình cuốiCheckout, portal và webhook đã nối sẵn; khóa live và price ID để lúc triển khai.

Với tích hợp sản phẩm, dùng một khóa TurnitPass cho mỗi môi trường. Production, staging và máy local phải thu hồi được độc lập.

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