REST API / tekst herschrijven

AI Humanizer-API voor bewerkbare, natuurlijke herschrijvingen

Stuur een concept, kies een humanizer-model en ontvang een nieuwe versie in je eigen workflow. Je kunt het resultaat bewerken, vergelijken en goedkeuren voordat je het publiceert.

Gebruik de sleutel uit een privéserveromgeving.

cURL-verzoek
curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'
01

POST-verzoeken naar /api/humanize/

02

Authenticatie met X-API-Key

03

Idempotency-Key van de client voor veilige nieuwe pogingen

04

Vier ondersteunde modellen

05

Aantal verwerkte woorden in elk antwoord

Een herschrijfstap die je zelf bepaalt

Houd het origineel, de herschrijving en de eindredactie in één workflow

Een nuttige humanizer-integratie verbergt niet wat er is veranderd. Bewaar het origineel, vraag een herschrijving aan en geef een redacteur een duidelijke plek om de twee versies te vergelijken voordat hij het resultaat goedkeurt.

Eenvoudige JSON-invoer

Verzend het concept en één ondersteunde modelnaam. Het antwoord retourneert platte tekst plus het model en het aantal verwerkte woorden.

De modelkeuze blijft expliciet

Selecteer cognia, lexi, cognia_v2 of huma_v2 op basis van het gedrag dat je team heeft getest voor de eigen inhoud.

Ontworpen om verder te bewerken

Plaats de geretourneerde tekst terug in een editor, revisiewachtrij of contentbeheersysteem in plaats van deze als een voltooid eindproduct te behandelen.

Verzoekcontract

Stuur het concept en geef het model een naam

Beide velden zijn vereist voor het REST-endpoint. Bewaar de modelkeuze in de configuratie, zodat je die kunt testen en wijzigen zonder de integratie te herschrijven.

VeldTypeVereistWat het doet
textstringJaDe aangeleverde tekst die je door de service wilt laten herschrijven.
modelstringJaEen van cognia, lexi, cognia_v2 of huma_v2.

Drie velden maken het resultaat eenvoudig te volgen

Gebruik humanized_text als bewerkbaar resultaat. Bewaar model_used en words_processed erbij, zodat support-, facturerings- en contentteams kunnen nagaan hoe het verzoek is verwerkt.

Voorbeeldantwoord
{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 8,
  "model_used": "cognia"
}

Integratiestappen

Behandel humanisering als een redactieronde

Een goede workflow houdt het origineel zichtbaar en laat iemand de nieuwe versie goedkeuren.

  1. 1

    Bescherm de API-sleutel

    Bewaar de sleutel op je server of in een beheeromgeving voor geheimen. Plaats die niet in openbare browsercode of een gedeeld document.

  2. 2

    Stuur tekst met een getest model

    Kies één ondersteund model, bewaar een unieke Idempotency-Key voordat je deze verzendt en gebruik die sleutel alleen voor een exacte nieuwe poging.

  3. 3

    Controleer en keur goed

    Controleer de herschreven tekst op nauwkeurigheid, betekenis, toon en vereiste terminologie voordat je deze opslaat of publiceert.

Geschikte toepassingen

Geschikt voor producten met een bestaande editor

Humanisering is vooral nuttig wanneer een concept al een beoordelingsproces doorloopt. De API voegt een herschrijfoptie toe zonder de mensen te vervangen die verantwoordelijk zijn voor de definitieve tekst.

Een herschrijving kan de betekenis veranderen

Namen, citaten, cijfers, juridische formuleringen en technische termen vereisen een zorgvuldige controle. Houd deze details zichtbaar voor de redacteur.

Contentbeheer

Bied een herschrijfactie aan binnen een CMS en stuur het resultaat terug naar hetzelfde concept ter vergelijking en goedkeuring.

Supportprocessen

Herzie goedgekeurd bronmateriaal in duidelijkere helpteksten en stuur het vervolgens via de normale feiten- en beleidsbeoordeling.

Redactionele wachtrijen

Voeg een herschrijfkandidaat toe naast het origineel, zodat een redacteur individuele wijzigingen kan behouden, combineren of afwijzen.

Privé schrijfhulpmiddelen

Roep de service aan vanuit een vertrouwde backend en geef alleen de geretourneerde tekst weer die de ingelogde gebruiker nodig heeft.

Veelgestelde vragen over de API

Praktische antwoorden voor je live gaat

Begin met een serververzoek, leg de structuur van het antwoord vast en voeg het resultaat daarna toe aan je bestaande beoordelingsproces.

Welk endpoint gebruikt de AI Humanizer-API?+

Stuur een POST-verzoek naar https://api.detecting-ai.com/api/humanize/. Gebruik JSON, geef je sleutel door in X-API-Key en behoud een stabiele Idempotency-Key voor elke logische bewerking, zodat nieuwe pogingen herstelbaar zijn.

Welke humanizer-modellen zijn beschikbaar?+

De ondersteunde modelwaarden zijn cognia, lexi, cognia_v2 en huma_v2. De REST API verwacht bij elke aanvraag het modelveld.

Wat houdt het antwoord in?+

Een succesvol antwoord bevat humanized_text, words_processed en model_used. De herschreven tekst blijft bewerkbaar in je product.

Moet de API-uitvoer zonder beoordeling worden gepubliceerd?+

Nee. Controleer het resultaat op betekenis, feiten, toon, namen, links en formuleringen die exact moeten blijven. Een herschrijving kan de tekst natuurlijker laten lopen, maar een redacteur blijft nodig.

Hoe wordt het gebruik van de humanizer geteld?+

Het gebruik is gebaseerd op het aantal ingevoerde woorden en wordt afgetrokken van de humanizerlimiet van het API-abonnement. Geslaagde antwoorden vermelden words_processed.

Bouw het eerste verzoek

Test het herschrijven op tekst die je goed kent

Begin met één model, vergelijk het resultaat met de bron en beslis welke controles je redacteuren nodig hebben voordat de functie wordt uitgebracht.