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ý rejstřík. Hodnota intensityScalar určuje, jak moc se přepis liší od zdroje, a nabývá jedné z hodnot 0, 0.25, 0.5, 0.75, 1 nebo 1.25, od Mírná přes výchozí Vyvážená na 0.5 a Agresivní na 1 až po ULTRA na 1.25.
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.
ULTRANEW!
ULTRA: Nejvyšší snížení AI skóre přes API
Nové šesté nastavení intenzity funguje na stejném endpointu. Nastavte intensityScalar na 1.25 pro ULTRA, maximální přepis humanizéru, s mírou snížení skóre GPTZero o 89 %.
Snížení AI skóre vs. sémantická věrnost vs. gramatika
- Snížení AI skóre (GPTZero, %)
- Sémantická věrnost (podpora NLI × 100)
- Gramatika (LanguageTool označuje na 1 000 slov)
Jeden parametr
Nastavte intensityScalar na 1.25 v požadavku, který již odesíláte. Koncový bod, Bearer klíč a odpověď JSON zůstávají stejné.
Maximální přepsání
ULTRA přepisuje více z každého odstavce než jakékoli jiné nastavení, s nejvyšším snížením AI skóre, za cenu mírně nižší čitelnosti a gramatiky. Před odevzdáním výstup revidujte.
Pouze anglický text
ULTRA funguje pouze s anglickým textem. Dalších pět nastavení pokrývá všechny jazyky, které API podporuje.
Účtováno za každé vstupní slovo
Požadavek ULTRA je účtován za každé vstupní slovo, stejně jako u každého jiného nastavení, a požadavek, který se enginu nepodaří dokončit, vrátí jeho 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 hodnot 0, 0.25, 0.5, 0.75, 1 nebo 1.25. Jak daleko se přepis odchyluje od zdroje, od Mírná přes Vyvážená a Agresivní až po ULTRA. ULTRA (1.25) funguje pouze pro anglický text. |
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.keptLinesNadpisy, seznamy, tabulky, rovnice a odkazy vrácené přesně tak, jak byly napsány. Uvádí se jen tehdy, když text takové řádky obsahuje.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.INSUFFICIENT_PROSEText má vedle nadpisů, seznamů, tabulek, rovnic nebo odkazů 50 slov tělových odstavců nebo méně, takže je jich příliš málo na humanizaci. Nic se neúčtuje; přidejte více odstavců a opakujte volání.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.