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 akademicki, korporacyjny, kreatywny, blog/SEO i ogólny. Wartość intensityScalar określa, jak bardzo przepisana wersja różni się od źródła, i przyjmuje jedną z wartości 0, 0.25, 0.5, 0.75, 1 lub 1.25, od Łagodny przez domyślny Zrównoważony przy 0.5 i Agresywny przy 1 aż po ULTRA przy 1.25.
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.
ULTRANEW!
ULTRA: Najwyższa redukcja wyniku AI przez API
Nowe szóste ustawienie intensywności działa na tym samym punkcie końcowym. Ustaw intensityScalar na 1.25 dla ULTRA, maksymalnej przeróbki humanizera, z 89% współczynnikiem redukcji wyniku GPTZero.
Redukcja wyniku AI vs. wierność semantyczna vs. gramatyka
- Redukcja wyniku AI (GPTZero, %)
- Wierność semantyczna (wsparcie NLI × 100)
- Gramatyka (LanguageTool oznacza na 1,000 słów)
Jeden parametr
Ustaw intensityScalar na 1.25 w żądaniu, które już wysyłasz. Punkt końcowy, klucz Bearer i odpowiedź JSON pozostają bez zmian.
Maksymalna przeróbka
ULTRA przepisuje więcej każdego akapitu niż jakiekolwiek inne ustawienie, zapewniając najwyższe obniżenie wyniku AI, kosztem nieco niższej czytelności i gramatyki. Przejrzyj wynik przed wysłaniem.
Tylko tekst po angielsku
ULTRA działa tylko na tekście angielskim. Pozostałe pięć ustawień obejmuje każdy język obsługiwany przez API.
Rozliczane za każde słowo wejściowe
Żądanie ULTRA jest rozliczane za każde słowo wejściowe, tak samo jak każde inne ustawienie, a jeśli silnik nie zdoła go ukończyć, jego słowa automatycznie wracają 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 wartości 0, 0.25, 0.5, 0.75, 1 lub 1.25. Jak bardzo przeredagowanie odbiega od źródła, od Łagodny przez Zrównoważony i Agresywny do ULTRA. ULTRA (1.25) działa tylko na tekście angielskim. |
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.keptLinesNagłówki, listy, tabele, równania i odwołania zwrócone dokładnie bez zmian. Występuje tylko wtedy, gdy tekst zawiera takie wiersze.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.INSUFFICIENT_PROSETekst zawiera 50 słów lub mniej w akapitach tekstu głównego obok nagłówków, list, tabel, równań lub odwołań, więc jest zbyt mało do zhumanizowania. Nic nie jest naliczane; dodaj więcej akapitów i ponów próbę.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.