Eenvoudige JSON-invoer
Verzend het concept en één ondersteunde modelnaam. Het antwoord retourneert platte tekst plus het model en het aantal verwerkte woorden.
REST API / tekst herschrijven
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 --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"
}'POST-verzoeken naar /api/humanize/
Authenticatie met X-API-Key
Idempotency-Key van de client voor veilige nieuwe pogingen
Vier ondersteunde modellen
Aantal verwerkte woorden in elk antwoord
Een herschrijfstap die je zelf bepaalt
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.
Verzend het concept en één ondersteunde modelnaam. Het antwoord retourneert platte tekst plus het model en het aantal verwerkte woorden.
Selecteer cognia, lexi, cognia_v2 of huma_v2 op basis van het gedrag dat je team heeft getest voor de eigen inhoud.
Plaats de geretourneerde tekst terug in een editor, revisiewachtrij of contentbeheersysteem in plaats van deze als een voltooid eindproduct te behandelen.
Verzoekcontract
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.
| Veld | Type | Vereist | Wat het doet |
|---|---|---|---|
| text | string | Ja | De aangeleverde tekst die je door de service wilt laten herschrijven. |
| model | string | Ja | Een van cognia, lexi, cognia_v2 of huma_v2. |
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.
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 8,
"model_used": "cognia"
}Integratiestappen
Een goede workflow houdt het origineel zichtbaar en laat iemand de nieuwe versie goedkeuren.
Bewaar de sleutel op je server of in een beheeromgeving voor geheimen. Plaats die niet in openbare browsercode of een gedeeld document.
Kies één ondersteund model, bewaar een unieke Idempotency-Key voordat je deze verzendt en gebruik die sleutel alleen voor een exacte nieuwe poging.
Controleer de herschreven tekst op nauwkeurigheid, betekenis, toon en vereiste terminologie voordat je deze opslaat of publiceert.
Geschikte toepassingen
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.
Namen, citaten, cijfers, juridische formuleringen en technische termen vereisen een zorgvuldige controle. Houd deze details zichtbaar voor de redacteur.
Bied een herschrijfactie aan binnen een CMS en stuur het resultaat terug naar hetzelfde concept ter vergelijking en goedkeuring.
Herzie goedgekeurd bronmateriaal in duidelijkere helpteksten en stuur het vervolgens via de normale feiten- en beleidsbeoordeling.
Voeg een herschrijfkandidaat toe naast het origineel, zodat een redacteur individuele wijzigingen kan behouden, combineren of afwijzen.
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
Begin met een serververzoek, leg de structuur van het antwoord vast en voeg het resultaat daarna toe aan je bestaande beoordelingsproces.
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.
De ondersteunde modelwaarden zijn cognia, lexi, cognia_v2 en huma_v2. De REST API verwacht bij elke aanvraag het modelveld.
Een succesvol antwoord bevat humanized_text, words_processed en model_used. De herschreven tekst blijft bewerkbaar in je product.
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.
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
Begin met één model, vergelijk het resultaat met de bron en beslis welke controles je redacteuren nodig hebben voordat de functie wordt uitgebracht.