AI Humanizer API
Humanizuj tekst AI w swoim produkcie jednym wywołaniem REST. API humanizera AI udostępnia silnik, który zasila TextPulse, Twojemu backendowi: JSON trafia do wejścia, przepisana proza wraca na wyjściu, w ponad 60 językach.
Wykonywanie pierwszego żądania
Uwierzytelnij się nagłówkiem Authorization: Bearer i wyślij swój tekst. Przepisana wersja zwraca się jako outputText wraz z danymi rozliczeniowymi dla tego wywołania.
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" }}Co API humanizera AI robi za Ciebie
Routing językowy, kontrola rejestru, rozliczanie i bezpieczeństwo ponowień są częścią punktu końcowego, więc integracja pozostaje jedną funkcją.
Jedna trasa obejmuje ponad 60 języków
Angielski działa na dopracowanym silniku humanizera. Przekaż wartość języka, a żądanie zostanie skierowane do ścieżki wielojęzycznej, więc nieanglojęzyczna strona produktu korzysta z tego samego punktu końcowego bez drugiej integracji.
Rejestr i siła są parametrami
Pięć trybów pisania obejmuje rejestry Academic, Corporate, Creative, Blog/SEO i General. Wartość intensityScalar określa, jak bardzo przepisanie różni się od źródła, i przyjmuje jedną z wartości 0, 0.25, 0.5, 0.75 lub 1, od Mild przez domyślne Balanced przy 0.5 aż po Aggressive.
Jedno POST na dokument
Nie ma kolejki zadań do odpytywania ani webhooka do rejestracji. Wywołanie humanize utrzymuje połączenie, dopóki model nie zwróci odpowiedzi, i odpowiada przepisanym tekstem, więc jedno żądanie kończy pracę.
Ponowienia nie są naliczane podwójnie
Wyślij requestId, a wynik będzie buforowany na około dziesięć minut. Powtórzenie tego samego identyfikatora w tym oknie odtwarza zapisane odpowiedzi zamiast ponownego uruchamiania modelu, a każde żądanie, którego silnik nie zdoła ukończyć, automatycznie zwraca jego treść do Twojego salda.
Dokumentacja punktów końcowych
Authorization: Bearer. Klucze zaczynają się od tp_live_ i są wydawane dla każdego projektu./api/v1/humanize/api/v1/balanceJedno wywołanie humanize przyjmuje do 1,000 słów przy limicie 10,000 znaków, a każdy klucz może wysyłać 60 żądań na minutę. Dłuższe dokumenty są wysyłane jako sekwencja wywołań.
Parametry żądania
Wymagany jest tylko text. Wszystko inne ma sensowną wartość domyślną, więc minimalna integracja to jedno pole.
| Parametr | Type | Obecność | Uwagi |
|---|---|---|---|
text | string | Wymagany | Tekst do humanizacji. Do 1,000 słów w limicie 10,000 znaków na żądanie. |
writingMode | string | Domyślnie: Academic | Jedna z opcji: Academic, Corporate, Creative, Blog/SEO lub General. Określa rejestr, który zachowuje przepisanie. |
intensityScalar | number | Domyślnie: 0.5 | Jedna z opcji: 0, 0.25, 0.5, 0.75 lub 1. Określa, jak daleko przepisanie odchodzi od źródła, od Mild przez Balanced do Aggressive. |
language | string | Opcjonalny | Kieruje tekst nieangielski do ścieżki wielojęzycznej. Pomiń to albo wyślij tekst angielski, aby użyć dopracowanego silnika angielskiego. |
englishVariant | string | Opcjonalny | Amerykański lub brytyjski. Utrzymuje pisownię i słownictwo po jednej stronie Atlantyku. |
freezeTerms | string[] | Opcjonalny | Do 10 terminów lub fraz zachowanych dosłownie w trakcie przepisywania: tworzenie nazw, instrumentów, nazw produktów. |
removeEmDashes | boolean | Opcjonalny | Przepisuje konstrukcje z em dash na konwencjonalną interpunkcję. |
requestId | string | Zalecany | Twój token idempotencji. Powtórzenie go w ciągu około dziesięciu minut odtwarza zapisanej odpowiedzi zamiast ponownego naliczania opłaty. |
Pola odpowiedzi
outputTextTekst po humanizacji.metrics.inputWords / outputWordsLiczba otrzymanych słów i liczba zwróconych słów. Przepisania często są nieco dłuższe niż źródło.metrics.wordsChargedKoszt wywołania. Zawsze równy liczbie słów wejściowych, nigdy liczbie słów wyjściowych.metrics.balanceRemainingPozostałe kredyty słowne na kluczu po tym wywołaniu, aby można było mierzyć zużycie bez drugiego żądania.metrics.modelLatencyMs / routeCzas silnika potrzebny na przepisanie i ścieżka, która je obsłużyła.Błędy i ponawianie
Każdy błąd zwraca JSON ze stabilnym error.code i komunikatem zrozumiałym dla człowieka. Zasada, wokół której warto projektować: opłata jest naliczana wyłącznie za dostarczone przepisanie, a ponowienie z tym samym requestId jest zawsze bezpieczne.
UNAUTHORIZEDBrakujący lub nierozpoznany klucz API. Sprawdź nagłówek Authorization: Bearer.INSUFFICIENT_BALANCENiewystarczająca liczba kredytów słownych na kluczu. Odpowiedź zawiera dostępne saldo.REQUEST_IN_PROGRESSŻądanie o tym requestId jest nadal przetwarzane. Poczekaj na nie, zamiast uruchamiać je równolegle.TOO_LONG / VALIDATION_FAILEDWejście przekracza limit 1,000 słów albo parametr ma nieprawidłowy format. Odpowiedź podaje dokładne problemy.ENGINE_ERRORSilnik nie powiódł się lub przekroczył limit czasu. Słowa zostały już przywrócone na Twoje saldo, ponów próbę z tym samym requestId.Silnik stojący za punktem końcowym
Każde wywołanie uruchamia opublikowany silnik TextPulse, mierzony na korpusie akademickim liczącym 2,000 dokumentów i ponownie testowany wraz z aktualizacją modeli detekcji. Wskaźniki niskich wyników według detektora:
Wyniki mierzone przez dostawcę, opublikowane wraz z ich korpusem. Żaden humanizator nie może obiecać wyniku wykrywania dla konkretnego dokumentu, dlatego buduj komunikację swojego produktu na podstawie pomiaru, nigdy na podstawie gwarancji.
Co zespoły budują na API humanizera
EdTech i platformy do pisania
Dodaj akcję humanizacji obok istniejących funkcji gramatyki lub parafrazy. Tryb Academic zachowuje cytowania w niezmienionej postaci, więc narzędzia skierowane do studentów nie muszą usuwać odwołań przed wysłaniem tekstu.
Narzędzia do pracy z dokumentami i korekty
Przepuszczaj całe dokumenty w 1,000-słownych fragmentach i składaj je ponownie. Freeze terms utrzymuje nazwy i terminologię w stałej postaci między fragmentami, a idempotentne ponowienia sprawiają, że potoki wsadowe można bezpiecznie uruchamiać ponownie.
Produkty do treści i SEO
Tryb Blog/SEO przepisuje szkice na tekst gotowy do publikacji, a freeze terms blokuje docelowe słowa kluczowe, dzięki czemu tekst zachowuje intencję wyszukiwania i traci mechaniczny rytm.
Partnerzy white-label
Punkt końcowy działa niewidocznie wewnątrz Twojego produktu: Twój interfejs, Twoje rozliczenia, nasz silnik. Warunki partnerskie są wyceniane na podstawie miesięcznego wolumenu za pośrednictwem formularza dostępu.
Cennik API humanizera AI
Środki są opłacone z góry i pobierane słowo po słowie. Rozliczenia liczą to, co wysyłasz, nigdy to, co zwraca silnik, a każde wywołanie, które nie wygeneruje przepisanego tekstu, jest zwracane z powrotem na klucz.
Kredyty są ważne przez 12 miesięcy od zakupu i obejmują każdy język, tryb pisania oraz wariant angielskiego obsługiwany przez endpoint. W przypadku stałego wolumenu lub modelu white-label w ramach własnego produktu, poproś o dostęp, a przygotujemy wycenę na podstawie miesięcznego wolumenu.
Uzyskaj klucz API
Klucze są wydawane dla każdego projektu osobno. Opisz, co tworzysz, a odpowiemy w ciągu 24 godzin.