AI Humanizer 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 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 proti němu uloží do mezipaměti přibližně na deset minut. Opakování stejného identifikátoru v tomto okně přehraje uloženou odpověď místo opětovného spuštění modelu a jakýkoli request, který se enginu nepodaří dokončit, vrátí jeho slova automaticky zpět na váš zůstatek.
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í zachovaných doslovně beze změny při přepisu: tvoření jmen, nástrojů, názvů 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á. Počkejte na něj, místo abyste ho spouštěli souběž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 nízkého skóre podle detektoru:
Ukazatele měřené dodavatelem, publikované spolu s jejich korpusem. Žádný humanizátor nemůže slíbit výsledek detektoru pro konkrétní dokument, proto stavte komunikaci svého produktu na měření, nikdy na záruku.
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 jsou předplacené a čerpají se podle počtu slov. Fakturace počítá to, co odešlete, nikdy to, co vrátí engine, a jakýkoli hovor, který nevytvoří přepis, se vám 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.
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.