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.
https://api.detecting-ai.comcurl --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.
| Interface | Authenticatie | Voorbeeld |
|---|---|---|
| REST API | X-API-Key | X-API-Key: YOUR_API_KEY |
| Gehoste MCP-connector | OAuth 2.0 met PKCE | Voeg alleen de MCP-URL toe, meld je aan en keur de toegang goed |
| Lokale MCP-client | Authorization | Bearer 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.
| Koptekst | Status | Contract |
|---|---|---|
Idempotency-Key | Sterk aanbevolen | 8–128 URL-veilige tekens. Genereer een willekeurige waarde per logische bewerking en behoud deze bij nieuwe pogingen. |
X-Idempotency-Key | Antwoord | Geeft bij geslaagde antwoorden en meetfouten de geaccepteerde sleutel van de client of compatibiliteitssleutel terug. |
X-Idempotency-Key-Source | Compatibiliteitsreactie | Wordt 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.
/api/detect/Requestbody
| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
text | string | Ja | Tekst om te analyseren. |
version | string | Ja | v1, v2 of v3. Gebruik v3 voor een nieuwe integratie. |
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
{
"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.
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.
/api/humanize/Requestbody
| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
text | string | Ja | Tekst om te herschrijven. |
model | string | Ja | cognia, lexi, cognia_v2 of huma_v2. |
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
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 120,
"model_used": "cognia"
}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.
/api/plagiarism/Requestbody
| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
text | string | Ja | Tekst om te controleren op bronoverlapping op zinsniveau. |
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
{
"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.
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.
https://api.detecting-ai.com/api/mcp| Tool | Doel | Standaard |
|---|---|---|
detect_ai_text | Analyseer tekst op AI-schrijfsignalen en details op zinsniveau. | version: v3 |
humanize_text | Herschrijf 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
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 = 300Claude Code
claude mcp add --transport http --scope user \
--header "Authorization: Bearer YOUR_API_KEY" \
detecting-ai https://api.detecting-ai.com/api/mcpAfhandeling van storingen
Fouten
Controleer zowel de HTTP-status als de antwoordtekst. Foutpayloads zijn nog niet genormaliseerd in één universeel schema.
| Status | Betekenis | Wat te controleren |
|---|---|---|
400 | Ongeldig verzoek of onvoldoende resterende woorden | Verplichte velden, ondersteunde versie of model en beschikbare woorden |
401 | Authenticatie ontbreekt of is ongeldig | X-API-Key-header voor REST of bearer-token voor MCP |
403 | Geen actief abonnement voor de functie | Planstatus en toegang tot het aangevraagde product |
409 | De bewerking is al bezig, of de sleutel wordt hergebruikt voor een andere bewerking | Respecteer 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. |
410 | De voltooide bewerking valt buiten de afgeschermde herhaaltermijn van 24 uur | Dien dezelfde logische bewerking niet opnieuw in. De blijvende markering voorkomt dubbele uitvoering. |
429 | Tijdelijke verzoeklimiet bereikt | Houd je aan Retry-After en verminder het aantal gelijktijdige verzoeken |
502 | De geselecteerde analyseprovider heeft de bewerking veilig afgebroken | Probeer het later opnieuw. Er is geen geslaagd resultaat geretourneerd en er zijn geen woorden afgeschreven. |
503 | Abonnementsverificatie of gebruiksregistratie is niet beschikbaar | Probeer 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.