Dành cho nhà phát triển

AI Humanizer API

Nhân hóa văn bản AI trong sản phẩm của bạn chỉ với một lệnh REST. API humanizer AI cung cấp cho backend của bạn công cụ vận hành TextPulse: JSON đi vào, văn xuôi đã viết lại đi ra, bằng hơn 60 ngôn ngữ.

Yêu cầu quyền truy cập APIĐọc ví dụ
POSThttps://textpulse.ai/api/v1/humanize

Tạo yêu cầu đầu tiên

Xác thực bằng tiêu đề Authorization: Bearer và gửi văn bản của bạn. Phiên bản đã viết lại được trả về dưới dạng outputText cùng với các số liệu đo lường cho lần gọi đó.

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  }'
200 OKapplication/json
{  "outputText": "Our analysis points to measurable gains from the...",  "metrics": {    "inputWords": 128, "outputWords": 134,    "wordsCharged": 128, "balanceRemaining": 99872,    "modelLatencyMs": 4310, "route": "v1/humanize"  }}

API humanizer AI xử lý gì cho bạn

Định tuyến ngôn ngữ, kiểm soát văn phong, đo lường và an toàn khi thử lại đều là một phần của điểm cuối, nên tích hợp của bạn vẫn chỉ là một hàm.

Một tuyến bao phủ hơn 60 ngôn ngữ

Tiếng Anh chạy trên công cụ humanizer đã tinh chỉnh. Hãy truyền một giá trị ngôn ngữ và yêu cầu sẽ được chuyển sang tuyến đa ngôn ngữ, để trang sản phẩm không phải tiếng Anh vẫn dùng cùng một điểm cuối mà không cần tích hợp thứ hai.

Văn phong và mức độ là các tham số

Năm chế độ viết bao phủ các phong cách Học thuật, Doanh nghiệp, Sáng tạo, Blog/SEO và Chung. Giá trị intensityScalar đặt mức độ khác biệt của bản viết lại so với bản gốc và nhận một trong các giá trị 0, 0.25, 0.5, 0.75, 1 hoặc 1.25, từ Nhẹ qua mặc định Cân bằng ở 0.5 và Mạnh mẽ ở 1 đến ULTRA ở 1.25.

Một POST cho mỗi tài liệu

Không có hàng đợi tác vụ để thăm dò và cũng không có webhook để đăng ký. Lệnh humanize giữ kết nối cho đến khi mô hình trả về và phản hồi bằng văn bản đã viết lại, nên một yêu cầu duy nhất hoàn tất công việc.

Thử lại không bị tính phí hai lần

Gửi một requestId và kết quả sẽ được lưu vào bộ nhớ đệm dựa trên nó trong khoảng mười phút. Việc lặp lại cùng một định danh trong khoảng thời gian đó sẽ phát lại phản hồi đã lưu thay vì chạy lại mô hình, và bất kỳ yêu cầu nào mà công cụ không hoàn tất sẽ tự động trả lại lời của nó vào số dư của bạn.

ULTRANEW!

ULTRA: Mức giảm điểm AI cao nhất thông qua API

Cài đặt cường độ thứ sáu mới hoạt động trên cùng một endpoint. Đặt intensityScalar thành 1.25 cho ULTRA, mức viết lại tối đa của công cụ nhân hóa, với tỷ lệ giảm điểm GPTZero là 89%.

Giảm điểm AI so với Độ trung thành ngữ nghĩa so với ngữ pháp

025507510050%59%68%76%78%89%NhẹVừa phảiCân bằngMạnhMạnh mẽULTRA
  • Giảm điểm AI (GPTZero, %)
  • Độ trung thành ngữ nghĩa (hỗ trợ NLI × 100)
  • Ngữ pháp (LanguageTool gắn cờ trên mỗi 1.000 từ)
Từ Mild đến Ultra, mức giảm điểm AI tăng từ 50% lên 89%. Mức giảm điểm AI tăng lên với cái giá là độ trung thành ngữ nghĩa, ngữ pháp và khả năng đọc tổng thể giảm nhẹ.

Một tham số

Đặt intensityScalar thành 1.25 trong yêu cầu mà bạn đã gửi. Endpoint, khóa Bearer và phản hồi JSON vẫn giữ nguyên.

Bản viết lại tối đa

ULTRA viết lại nhiều hơn ở mỗi đoạn văn so với bất kỳ cài đặt nào khác, với mức giảm điểm AI cao nhất, đổi lại khả năng đọc hiểu và ngữ pháp thấp hơn một chút. Hãy rà soát đầu ra trước khi nộp.

Chỉ văn bản tiếng Anh

ULTRA chỉ hoạt động với văn bản tiếng Anh. Năm cài đặt còn lại bao phủ mọi ngôn ngữ mà API hỗ trợ.

Tính phí theo mỗi từ đầu vào

Một yêu cầu ULTRA được tính phí theo từng từ đầu vào, giống như mọi cài đặt khác, và nếu công cụ không hoàn thành được một yêu cầu thì số từ của yêu cầu đó sẽ tự động được hoàn lại vào số dư của bạn.

Nhận API key của bạn

Tham chiếu điểm cuối

Cả hai tuyến đều đọc khóa của bạn từ tiêu đề Authorization: Bearer. Khóa bắt đầu bằng tp_live_ và được cấp theo từng dự án.
POST/api/v1/humanize
Viết lại văn bản do AI tạo thành văn xuôi tự nhiên.
GET/api/v1/balance
Đọc số tín dụng từ khóa của bạn còn lại.

Một lệnh humanize duy nhất chấp nhận tối đa 1,000 từ trong giới hạn 10,000 ký tự, và mỗi khóa có thể phát hành 60 yêu cầu mỗi phút. Tài liệu dài hơn được gửi dưới dạng chuỗi lệnh.

Tham số yêu cầu

Chỉ cần text. Mọi thứ khác đều có giá trị mặc định hợp lý, vì vậy tích hợp tối thiểu chỉ cần một trường.

Tham sốTypeBắt buộcGhi chú
textstringBắt buộcVăn bản cần humanize. Tối đa 1,000 từ trong giới hạn 10,000 ký tự cho mỗi yêu cầu.
writingModestringMặc định: AcademicMột trong Academic, Corporate, Creative, Blog/SEO hoặc General. Thiết lập phong cách mà bản viết lại giữ nguyên.
intensityScalarnumberMặc định: 0.5Một trong các giá trị 0, 0.25, 0.5, 0.75, 1 hoặc 1.25. Mức độ viết lại khác với văn bản nguồn đến đâu, từ Nhẹ qua Cân bằng và Mạnh mẽ đến ULTRA. ULTRA (1.25) chỉ hoạt động với văn bản tiếng Anh.
languagestringTùy chọnChuyển văn bản không phải tiếng Anh sang lộ trình đa ngôn ngữ. Bỏ qua, hoặc gửi tiếng Anh, để dùng engine tiếng Anh đã tinh chỉnh.
englishVariantstringTùy chọnTiếng Anh Mỹ hoặc Anh. Giữ chính tả và từ vựng theo một phía của Đại Tây Dương.
freezeTermsstring[]Tùy chọnTối đa 10 thuật ngữ hoặc cụm từ được giữ nguyên nguyên văn trong quá trình viết lại: xây dựng tên, nhạc cụ, tên sản phẩm.
removeEmDashesbooleanTùy chọnViết lại các cấu trúc dấu gạch ngang dài thành dấu câu thông thường.
requestIdstringKhuyến nghịMã định danh idempotency của bạn. Nếu lặp lại trong khoảng mười phút, hệ thống sẽ phát lại phản hồi đã lưu thay vì tính phí lại.

Các trường phản hồi

outputTextVăn bản đã humanize.
metrics.inputWords / outputWordsSố từ đã nhận và số từ đã trả về. Các bản viết lại thường dài hơn một chút so với văn bản nguồn.
metrics.wordsChargedChi phí của lệnh gọi. Luôn bằng số từ đầu vào, không bao giờ bằng số từ đầu ra.
metrics.balanceRemainingSố tín dụng từ còn lại trên khóa sau lệnh gọi này, để bạn có thể đo lường mà không cần một yêu cầu thứ hai.
metrics.modelLatencyMs / routeThời gian engine cho bản viết lại và lộ trình đã phục vụ.
keptLinesCác tiêu đề, danh sách, bảng, phương trình và tài liệu tham khảo được trả về nguyên văn. Chỉ hiển thị khi văn bản có các dòng như vậy.

Lỗi và thử lại

Mọi lỗi đều trả về JSON với error.code ổn định và một thông báo dễ đọc. Quy tắc đáng thiết kế theo: bạn chỉ bị tính phí cho một bản viết lại đã được cung cấp, và việc thử lại với cùng requestId luôn an toàn.

401UNAUTHORIZEDThiếu hoặc không nhận diện được khóa API. Kiểm tra header Authorization: Bearer.
402INSUFFICIENT_BALANCEKhông đủ tín dụng từ trên khóa. Phản hồi bao gồm số dư hiện có.
409REQUEST_IN_PROGRESSYêu cầu có requestId này vẫn đang được xử lý. Hãy đợi thay vì chạy đua với nó.
422TOO_LONG / VALIDATION_FAILEDĐầu vào vượt quá giới hạn 1,000 từ hoặc một tham số bị định dạng sai. Phản hồi liệt kê chính xác các vấn đề.
5xxENGINE_ERROREngine đã thất bại hoặc hết thời gian chờ. Số từ đã được hoàn lại vào số dư của bạn, hãy thử lại với cùng requestId.
422INSUFFICIENT_PROSEVăn bản có 50 từ của các đoạn văn thân bài hoặc ít hơn bên cạnh các tiêu đề, danh sách, bảng, phương trình hoặc tài liệu tham khảo, nên không đủ để nhân hóa. Không tính phí gì; hãy thêm nhiều đoạn văn hơn và thử lại.

Những gì các nhóm xây dựng trên API humanizer

Nền tảng EdTech và viết lách

Thêm một hành động humanize bên cạnh các tính năng ngữ pháp hoặc diễn đạt lại hiện có của bạn. Chế độ Academic giữ nguyên trích dẫn, vì vậy các công cụ hướng tới sinh viên không cần phải loại bỏ tài liệu tham khảo trước khi gửi văn bản.

Công cụ xử lý tài liệu và hiệu đính

Đưa toàn bộ tài liệu qua theo các đoạn 1.000 từ rồi ghép lại. Freeze terms giữ tên riêng và thuật ngữ ổn định giữa các đoạn, và các lần thử lại idempotent giúp các quy trình xử lý hàng loạt an toàn để chạy lại.

Sản phẩm nội dung và SEO

Chế độ Blog/SEO viết lại bản nháp thành văn bản có thể xuất bản, trong khi freeze terms khóa các từ khóa mục tiêu, để bản sao giữ được ý định tìm kiếm và mất đi nhịp điệu máy móc.

Đối tác white-label

Endpoint chạy ẩn bên trong sản phẩm của bạn: giao diện của bạn, thanh toán của bạn, động cơ của chúng tôi. Các thỏa thuận đối tác được báo giá theo khối lượng hàng tháng thông qua biểu mẫu truy cập.

Bảng giá API humanizer AI

Tín dụng được nạp trước và được trừ theo số từ. Phần thanh toán tính những gì bạn gửi, không phải những gì động cơ trả về, và mọi lần gọi không tạo ra bản viết lại sẽ được hoàn lại vào tài khoản theo key.

Starter
$28
100K từ
$0.28 mỗi 1,000 từ
Growth
$125
500K từ
$0.25 mỗi 1,000 từ
Pro
$440
2M từ
$0.22 mỗi 1,000 từ
Giá trị tốt nhấtScale
$2,000
10M từ
$0.20 mỗi 1,000 từ

Tín dụng có hiệu lực trong 12 tháng kể từ khi mua, và bao gồm mọi ngôn ngữ, chế độ viết và biến thể tiếng Anh mà endpoint hỗ trợ. Đối với khối lượng sử dụng liên tục hoặc một thỏa thuận white-label trong chính sản phẩm của bạn, yêu cầu quyền truy cập và chúng tôi sẽ báo giá theo con số hàng tháng của bạn.

Nhận API key của bạn

Key được cấp theo từng dự án. Hãy mô tả bạn đang xây dựng gì và chúng tôi sẽ phản hồi trong vòng 24 giờ.

Thông tin của bạn chỉ được dùng để cấp key và không cho mục đích nào khác.

Các câu hỏi về API humanizer AI