Documentatie voor ontwikkelaars

AI-detector-API en MCP-documentatie

Stuur JSON naar de REST API voor de detector, humanizer of plagiaatcontrole, of verbind de externe MCP-server met een compatibele assistent. De voorbeelden hieronder gebruiken de productiehostnaam en het huidige contract.

Begin hier

Snelstart

Maak in het API-dashboard een sleutel aan, kopieer die naar een beveiligde opslag, bevestig dat hij is opgeslagen en activeer hem. Stuur daarna JSON via HTTPS. Dit voorbeeld gebruikt Detector v3.

BASE-URLhttps://api.detecting-ai.com
Snelstart met cURL
curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

Houd privésleutels privé. Bewaar de sleutel in een server-side omgevingsvariabele of geheimenbeheer. Zet hem nooit in een browserbundel, mobiele app, openbare repository, schermafbeelding of gedeeld document. De volledige waarde verschijnt alleen vóór activering en is na het verlaten of herladen van de pagina niet te herstellen. Een vervangende sleutel voorbereiden onderbreekt de actieve sleutel niet; pas bij activering verandert de opgeslagen waarde.

Toegang

Authenticatie

REST-verzoeken en lokale MCP-clients gebruiken persoonlijke API-sleutels in verschillende headers. Gehoste MCP-connectors ontdekken OAuth en openen de autorisatie in de browser.

InterfaceAuthenticatieVoorbeeld
REST APIX-API-KeyX-API-Key: YOUR_API_KEY
Gehoste MCP-connectorOAuth 2.0 met PKCEVoeg alleen de MCP-URL toe, meld je aan en keur de toegang goed
Lokale MCP-clientAuthorizationBearer YOUR_API_KEY

Gebruiksveiligheid

Probeer één verzoek opnieuw zonder twee keer te betalen

Nieuwe integraties moeten voor elk logisch REST-verzoek een unieke Idempotency-Key versturen en die waarde bewaren totdat het verzoek slaagt of je de poging opgeeft. Valt de verbinding weg, herhaal dan exact hetzelfde endpoint met dezelfde tekst, versie of model en sleutel. Een exacte herhaling retourneert het opgeslagen antwoord zonder de provider opnieuw uit te voeren of woorden nogmaals af te schrijven.

KoptekstStatusContract
Idempotency-KeySterk aanbevolen8–128 URL-veilige tekens. Genereer een willekeurige waarde per logische bewerking en behoud deze bij nieuwe pogingen.
X-Idempotency-KeyAntwoordGeeft bij geslaagde antwoorden en meetfouten de geaccepteerde sleutel van de client of compatibiliteitssleutel terug.
X-Idempotency-Key-SourceCompatibiliteitsreactieWordt alleen ingesteld op server-generated wanneer bij een verouderd verzoek de Idempotency-Key ontbreekt.

Gebruik een sleutel nooit opnieuw met gewijzigde tekst, een ander endpoint, een andere detectorversie of een ander humanizer-model. De API koppelt deze velden aan het eerste gebruik en retourneert HTTP 409 als ze niet overeenkomen. Bestaande clients zonder header ontvangen een willekeurige sleutel in X-Idempotency-Key en X-Idempotency-Key-Source: server-generated. Gaat het volledige antwoord verloren, dan kan die gegenereerde sleutel niet worden hersteld en is een veilige herhaling onmogelijk. Nieuwe clients moeten vóór verzending altijd zelf een sleutel maken en bewaren.

Zolang het eerste verzoek nog bij de provider wordt uitgevoerd, retourneert een gelijktijdige exacte herhaling HTTP 409 met Retry-After. Na voltooiing blijft hetzelfde antwoord 24 uur opnieuw opvraagbaar. Zodra die afgeschermde respons verloopt, retourneert dezelfde sleutel HTTP 410. De blijvende registratie voorkomt nog steeds een tweede afschrijving.

REST-endpoint

AI-detector-API

Analyseer de aangeleverde tekst op patronen die verband houden met AI-schrijven. Resultaten zijn probabilistische beoordelingssignalen, geen bewijs van auteurschap.

POST/api/detect/

Requestbody

VeldTypeVereistBeschrijving
textstringJaTekst om te analyseren.
versionstringJav1, v2 of v3. Gebruik v3 voor een nieuwe integratie.
Detectorverzoek
curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

Antwoord

Antwoord van Detector v3
{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

Interpreteer de score zorgvuldig In het openbare compatibiliteitscontract van Detector v3 zijn segmenten op zinsniveau gelabeld als AI of Human. Elke segmentscore is de betrouwbaarheid van de provider, van 0 tot 1. Waarden boven 0,5 krijgen het label AI. Het totale ai_percentage is het percentage invoertekens binnen zinnen met het AI-label, niet het gemiddelde van de segmentscores. Dit verschilt van de nieuwere detectormethode op de website. Combineer de velden uit beide methoden daarom niet in één berekening.

Lees het overzicht van de AI-detector-API

Beide MCP-tools vereisen een argument idempotency_key van 16–128 URL-veilige tekens. Genereer het per bewuste toolbewerking en hergebruik het alleen voor een exacte nieuwe poging. De JSON-RPC-request-ID wordt niet als factureringssleutel gebruikt.

REST-endpoint

AI Humanizer-API

Herschrijf de aangeleverde tekst met een geselecteerd humanizermodel. De uitvoer is bewerkbaar en moet worden beoordeeld op betekenis, feiten, namen, links, toon en vereiste terminologie.

POST/api/humanize/

Requestbody

VeldTypeVereistBeschrijving
textstringJaTekst om te herschrijven.
modelstringJacognia, lexi, cognia_v2 of huma_v2.
Humanizer-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"
  }'

Antwoord

Antwoord van de humanizer
{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 120,
  "model_used": "cognia"
}

Lees het overzicht van de AI Humanizer-API

REST-endpoint

Plagiaatchecker-API

Zoek naar overlap op zinsniveau en retourneer broncontext bij een overeenkomst. Elke overeenkomst vraagt om menselijke beoordeling, omdat citaten, toestemming en gangbare formuleringen de betekenis beïnvloeden.

POST/api/plagiarism/

Requestbody

VeldTypeVereistBeschrijving
textstringJaTekst om te controleren op bronoverlapping op zinsniveau.
Plagiaatverzoek
curl --request POST \
  --url https://api.detecting-ai.com/api/plagiarism/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: plagiarism-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to check."
  }'

Antwoord

Antwoord van de plagiaatcontrole
{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

De score is niet uitputtend. plagiarism_score is het aandeel invoertekens binnen gemarkeerde zinnen. De checker doorzoekt kandidaat-webpagina's en retourneert de eerste overeenkomst die voor een zin aan de drempel voldoet. De afwezigheid van een match bewijst niet dat de tekst nergens anders is verschenen.

Lees het overzicht van de Plagiaatchecker-API

Streamable HTTP

Externe MCP-server

Eén externe server bevat precies twee tools: detect_ai_text en humanize_text. Plagiaatcontrole is beschikbaar via REST, niet via MCP.

MCPhttps://api.detecting-ai.com/api/mcp
ToolDoelStandaard
detect_ai_textAnalyseer tekst op AI-schrijfsignalen en details op zinsniveau.version: v3
humanize_textHerschrijf de aangeleverde tekst en retourneer een bewerkbaar resultaat.model: cognia

Gehoste connectoren

Voeg alleen de MCP-URL toe aan een gehoste connector. De client detecteert OAuth, opent de aanmelding en toestemming in de browser en bewaart zijn eigen tokens. Voeg geen API-sleutel of andere inloggegevens toe aan de URL.

Codex

Codex-configuratie
export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

Claude Code-opdracht
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Afhandeling van storingen

Fouten

Controleer zowel de HTTP-status als de antwoordtekst. Foutpayloads zijn nog niet genormaliseerd in één universeel schema.

StatusBetekenisWat te controleren
400Ongeldig verzoek of onvoldoende resterende woordenVerplichte velden, ondersteunde versie of model en beschikbare woorden
401Authenticatie ontbreekt of is ongeldigX-API-Key-header voor REST of bearer-token voor MCP
403Geen actief abonnement voor de functiePlanstatus en toegang tot het aangevraagde product
409De bewerking is al bezig, of de sleutel wordt hergebruikt voor een andere bewerkingRespecteer Retry-After voor een exacte herhaling terwijl het verzoek nog loopt. Genereer een nieuwe sleutel voor gewijzigde tekst, een ander endpoint, een andere versie of een ander model.
410De voltooide bewerking valt buiten de afgeschermde herhaaltermijn van 24 uurDien dezelfde logische bewerking niet opnieuw in. De blijvende markering voorkomt dubbele uitvoering.
429Tijdelijke verzoeklimiet bereiktHoud je aan Retry-After en verminder het aantal gelijktijdige verzoeken
502De geselecteerde analyseprovider heeft de bewerking veilig afgebrokenProbeer het later opnieuw. Er is geen geslaagd resultaat geretourneerd en er zijn geen woorden afgeschreven.
503Abonnementsverificatie of gebruiksregistratie is niet beschikbaarProbeer het exacte verzoek opnieuw met dezelfde Idempotency-Key. De service houdt de uitvoer van de provider in als de voltooiing onzeker is.

Voor bestaande clients blijven quotafouten op het hoogste niveau van de respons staan. Zonder actief abonnement retourneert de API HTTP 403 met error_code: "1002". Bij onvoldoende woorden volgt HTTP 400 met het oude foutveld en gestructureerde velden voor de resterende limiet.

Quota en grenzen

Gebruik en limieten

Het verbruik wordt bepaald door het aantal met witruimte gescheiden woorden in de invoer. De detector, humanizer en plagiaatcontrole hebben elk een eigen woordlimiet, ook als dezelfde sleutel toegang geeft tot meerdere producten.

  • Controleer de resterende woorden en actieve abonnementen in het API-dashboard.
  • MCP gebruikt dezelfde detector- of humanizerlimiet als de bijbehorende REST API.
  • REST en MCP hebben standaard een tekstlimiet van 160.000 tekens. Voor MCP geldt daarnaast een limiet van 1 MiB voor de transportbody. Splits uitzonderlijk grote documenten op in betekenisvolle delen.

Klaar om te integreren

Doe het eerste verzoek vanaf een vertrouwde server

Maak een sleutel, kies het juiste endpoint voor de taak en test zowel geslaagde antwoorden als fouten voordat je de gebruikersinterface toevoegt.