Humanizér AI API
Humanizujte text AI ve svém produktu jediným REST voláním. API humanizéru AI zpřístupňuje vašemu backendu jádro, které pohání TextPulse: vstupem je JSON, výstupem přepsaná próza, ve více než 60 jazycích.
Vytvoření prvního požadavku
Ověřte se hlavičkou Authorization: Bearer a odešlete svůj text. Přepsaná verze se vrátí jako outputText spolu s údaji o účtování pro toto volání.
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 je API humanizeru AI?
API humanizeru AI je REST endpoint, který přepisuje strojově generovaný text do přirozené, lidsky znějící prózy v rámci jiného produktu. Místo vkládání textu do webové aplikace jej vaše backendová část odešle jako JSON a v odpovědi obdrží přepsanou verzi, takže humanizace se stává funkcí vašeho vlastního softwaru, tlačítkem v editoru, krokem v dokumentovém pipeline nebo dávkovou úlohou nad knihovnou obsahu.
API humanizeru TextPulse zpřístupňuje stejný engine, který pohání dashboard TextPulse. Pracuje současně s více než 20 jazykovými signály, mění délku a strukturu vět a nahrazuje slovní zásobu, kterou jazykové modely nadměrně preferují, zatímco citace v textu, položky v seznamu literatury, statistiky a pevně daná terminologie procházejí doslova beze změny. Na akademickém korpusu o 2,000 dokumentech prošel humanizovaný výstup Turnitin AI v 92.33% případů, Originality.ai v 89.12% a GPTZero v 87.91%. Toto chování na akademické úrovni jej odlišuje od obecných endpointů pro parafrázování, text, který uživatelé dostanou zpět, je připravený k publikaci, nikoli jen odlišný.
Co za vás API humanizéru AI řeší
Směrování jazyka, řízení registru, účtování i bezpečné opakování jsou součástí koncového bodu, takže vaše integrace zůstává jedinou funkcí.
Jedna cesta pokrývá 60+ jazyků
Angličtina běží na jemně doladěném jádru humanizéru. Zadejte hodnotu jazyka a požadavek se místo toho přesměruje na vícejazyčnou cestu, takže neanglická produktová stránka používá stejný koncový bod bez druhé integrace.
Registr a síla jsou parametry
Pět režimů psaní pokrývá akademický, firemní, kreativní, blogový/SEO a obecný registr. Hodnota intensityScalar určuje, jak odlišný je přepis od zdroje, a nabývá jedné z hodnot 0, 0.25, 0.5, 0.75 nebo 1, od mírného přes výchozí vyvážený režim při 0.5 až po agresivní.
Jeden POST na dokument
Není zde žádná fronta úloh k dotazování ani webhook k registraci. Volání humanize drží spojení, dokud model nevrátí odpověď, a vrací přepsaný text, takže práci dokončí jediný požadavek.
Opakování se neúčtují dvakrát
Pošlete requestId a výsledek se k němu uloží přibližně na deset minut. Opakování stejného identifikátoru v tomto okně vrátí uloženou odpověď místo nového spuštění modelu a každý požadavek, který se enginu nepodaří dokončit, vrátí svá slova automaticky zpět do vašeho zůstatku.
Reference koncového bodu
Authorization: Bearer. Klíče začínají tp_live_ a jsou vydávány pro každý projekt./api/v1/humanize/api/v1/balanceJediné volání humanize přijímá až 1,000 slov v limitu 10,000 znaků a každý klíč může vydat 60 požadavků za minutu. Delší dokumenty se posílají jako sled volání.
Parametry požadavku
Vyžaduje se pouze text. Vše ostatní má rozumný výchozí stav, takže minimální integrace je jedno pole.
| Parametr | Type | Přítomnost | Poznámky |
|---|---|---|---|
text | string | Povinné | Text k humanizaci. Až 1,000 slov v rámci limitu 10,000 znaků na požadavek. |
writingMode | string | Výchozí hodnota: Academic | Jedna z možností Academic, Corporate, Creative, Blog/SEO nebo General. Určuje registr, který přepis zachovává. |
intensityScalar | number | Výchozí hodnota: 0.5 | Jedna z možností 0, 0.25, 0.5, 0.75 nebo 1. Určuje, jak daleko se přepis odchýlí od zdroje, od Mild přes Balanced až po Aggressive. |
language | string | Volitelné | Směruje neanglický text na vícejazyčnou cestu. Vynechte jej nebo odešlete angličtinu pro jemně doladěný anglický engine. |
englishVariant | string | Volitelné | Americká nebo britská varianta. Udržuje pravopis a slovní zásobu na jedné straně Atlantiku. |
freezeTerms | string[] | Volitelné | Až 10 termínů nebo frází, které projdou přepisem doslova beze změny: názvy konstrukcí, přístroje, názvy produktů. |
removeEmDashes | boolean | Volitelné | Přepisuje konstrukce s em dash do běžné interpunkce. |
requestId | string | Doporučeno | Váš token idempotence. Opakování v rozmezí přibližně deseti minut přehraje uloženou odpověď místo nového účtování. |
Pole odpovědi
outputTextHumanizovaný text.metrics.inputWords / outputWordsPočet přijatých a vrácených slov. Přepisy bývají obvykle o něco delší než zdroj.metrics.wordsChargedCena volání. Vždy se rovná počtu vstupních slov, nikdy ne počtu výstupních slov.metrics.balanceRemainingZbývající slovní kredity na klíči po tomto volání, abyste mohli měřit bez druhého požadavku.metrics.modelLatencyMs / routeDoba běhu enginu pro přepis a cesta, která jej obsloužila.Chyby a opakování
Každá chyba vrací JSON se stabilním error.code a čitelnou zprávou. Pravidlo, podle kterého se vyplatí navrhovat řešení, zní, že účtováni jste pouze za přepis, který byl doručen, a opakování se stejným requestId je vždy bezpečné.
UNAUTHORIZEDChybí API klíč nebo není rozpoznán. Zkontrolujte hlavičku Authorization: Bearer.INSUFFICIENT_BALANCENa klíči není dostatek slovních kreditů. Odpověď obsahuje dostupný zůstatek.REQUEST_IN_PROGRESSPožadavek s tímto requestId se stále zpracovává. Vyčkejte na něj místo souběžného opakování.TOO_LONG / VALIDATION_FAILEDVstup překračuje limit 1,000 slov nebo je parametr chybně zapsán. Odpověď uvádí přesné problémy.ENGINE_ERROREngine selhal nebo vypršel časový limit. Slova už byla vrácena na váš zůstatek, opakujte se stejným requestId.Motor za koncovým bodem
Každé volání spouští publikovaný engine TextPulse, měřený na akademickém korpusu o 2,000 dokumentech a znovu testovaný při aktualizaci detekčních modelů. Míra úspěšnosti podle detektoru:
Čísla měřená dodavatelem, zveřejněná spolu s jejich korpusem. Žádný humanizer nemůže slíbit výsledek detektoru pro konkrétní dokument, proto stavte sdělení svého produktu na měření, ne na zárukách.
Co týmy stavějí na API humanizeru
EdTech a platformy pro psaní
Přidejte akci humanizace vedle svých stávajících funkcí gramatiky nebo parafrázování. Režim Academic zachovává citace beze změny, takže nástroje pro studenty nemusí před odesláním textu odstraňovat odkazy.
Nástroje pro práci s dokumenty a korektury
Procházejte celé dokumenty v blocích po 1,000 slovech a znovu je sestavujte. Freeze terms udržují názvy a terminologii stabilní napříč bloky a idempotentní opakování zajišťují, že dávkové pipeline lze bezpečně spustit znovu.
Obsahové a SEO produkty
Režim Blog/SEO přepisuje návrhy do podoby vhodné k publikaci, zatímco freeze terms uzamykají cílová klíčová slova, takže text zachová svůj vyhledávací záměr a ztratí strojový rytmus.
White-label partneři
Endpoint běží neviditelně uvnitř vašeho produktu: vaše rozhraní, vaše fakturace, náš engine. Partnerské podmínky se stanovují podle měsíčního objemu prostřednictvím formuláře pro přístup.
Ceny API humanizéru AI
Kredity se předplácejí a čerpají podle počtu slov. Účtování počítá to, co odešlete, nikoli to, co engine vrátí, a každé volání, které nepřinese přepis, se vrátí zpět na klíč.
Kredity jsou platné 12 měsíců od nákupu a pokrývají každý jazyk, režim psaní a variantu angličtiny, kterou endpoint podporuje. Pro trvalý objem nebo white-label uspořádání ve vašem vlastním produktu, požádejte o přístup a připravíme cenovou nabídku podle vašeho měsíčního objemu.
Otázky k API humanizéru AI
Získejte API klíč
Klíče se vydávají pro každý projekt zvlášť. Popište, co vytváříte, a odpovíme do 24 hodin.