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ữ.
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 }'{ "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 văn phong Academic, Corporate, Creative, Blog/SEO và General. Giá trị intensityScalar xác định mức độ khác biệt của bản viết lại so với văn bản gốc và nhận một trong các giá trị 0, 0.25, 0.5, 0.75 hoặc 1, từ Mild qua Balanced mặc định ở 0.5 đến Aggressive.
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.
Tham chiếu điểm cuối
Authorization: Bearer. Khóa bắt đầu bằng tp_live_ và được cấp theo từng dự án./api/v1/humanize/api/v1/balanceMộ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ố | Type | Bắt buộc | Ghi chú |
|---|---|---|---|
text | string | Bắt buộc | Vă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. |
writingMode | string | Mặc định: Academic | Mộ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. |
intensityScalar | number | Mặc định: 0.5 | Một trong 0, 0.25, 0.5, 0.75 hoặc 1. Mức độ bản viết lại lệch khỏi văn bản nguồn, từ Mild qua Balanced đến Aggressive. |
language | string | Tùy chọn | Chuyể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. |
englishVariant | string | Tùy chọn | Tiế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. |
freezeTerms | string[] | Tùy chọn | Tố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. |
removeEmDashes | boolean | Tùy chọn | Viế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. |
requestId | string | Khuyế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ụ.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.
UNAUTHORIZEDThiếu hoặc không nhận diện được khóa API. Kiểm tra header Authorization: Bearer.INSUFFICIENT_BALANCEKhông đủ tín dụng từ trên khóa. Phản hồi bao gồm số dư hiện có.REQUEST_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ó.TOO_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 đề.ENGINE_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.Động cơ đứng sau endpoint
Mỗi lần gọi đều chạy trên động cơ TextPulse đã công bố, được đo trên một ngữ liệu học thuật gồm 2.000 tài liệu và chạy lại khi các mô hình phát hiện được cập nhật. Tỷ lệ vượt qua theo từng bộ phát hiện:
Các số liệu do nhà cung cấp đo lường, được công bố cùng với tập ngữ liệu của họ. Không có humanizer nào có thể hứa hẹn kết quả của một bộ phát hiện đối với một tài liệu cụ thể, vì vậy hãy xây dựng thông điệp sản phẩm của bạn dựa trên phép đo, không dựa trên một lời đảm bảo.
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.
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ờ.