GPTZero API

Name: GPTZero API
Brand: GPTZero API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAI/MLMl InferenceapiKey7 EndpointsREST

For Agents

Score text or uploaded documents for AI-generation likelihood with per-sentence breakdowns. Supports single-document, batch, and report retrieval flows.

Install Jentic One Beta

Connect the GPTZero API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GPTZero API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GPTZero API.

Score a passage of text for AI authorship via POST /predict/text

Analyse uploaded documents (PDF, DOCX, TXT) through POST /predict/files

Submit a batch of documents for asynchronous scoring via POST /batch

GET STARTED

Start building with GPTZero API

Explore with Jentic

View OpenAPI Document

GPTZero is an AI-text detection service used widely in education and publishing to score whether a passage was written by a human or generated by a large language model. The v2 API exposes seven endpoints across single-text scoring, document file analysis, batch submission, and report retrieval, returning per-document and per-sentence probability scores plus optional perplexity and burstiness metrics. It is designed for teachers, editors, and platform integrity teams who need a programmatic signal on AI-generated content.

Use Cases

Patterns agents use GPTZero API for, with concrete tasks.

★ School-Wide Submission Screening

Schools submitting student work into a GPTZero workflow use POST /batch to send a class-worth of essays in one request, then poll GET /batch/{batchId} until results are ready. The per-sentence scoring helps teachers see exactly which passages triggered the model. Detection is probabilistic — schools should treat the score as a triage signal and pair it with a conversation with the student.

POST /batch with 30 essay bodies, poll GET /batch/{batchId} every 10 seconds until status=complete, then surface essays with score above 0.7.

Editorial Content Authenticity Check

Publishers screen freelance submissions through POST /predict/text or /predict/files to flag pieces that may be AI-generated for additional review. The endpoint returns overall and per-sentence probabilities plus perplexity metrics, giving editors a defensible signal before contracting with a writer. The API does not authenticate authorship — it scores statistical likelihood only.

POST /predict/text with a 1500-word draft and route the submission to a senior editor when document_classification is 'AI-generated'.

Document File Analysis

POST /predict/files accepts PDF, DOCX, and TXT uploads, extracting the text server-side and returning the same scoring shape as /predict/text. This avoids the agent having to parse mixed file formats locally and keeps OCR and extraction logic on GPTZero's side. Maximum file size is bounded by the user's plan tier.

POST /predict/files with a multipart upload of a PDF and return the per-paragraph AI-generation probabilities.

Account-Level Report Auditing

Compliance and academic-integrity teams pull historical detections via GET /reports for retention or audit purposes. GET /reports/{reportId} returns the full prior verdict including the input text snapshot, score, and timestamp, supporting policies that require evidence to be preserved alongside the decision.

Call GET /reports?limit=50, filter to the past 7 days, and produce a summary of how many submissions exceeded the 0.7 threshold.

Agent Detection via Jentic

An agent moderating user-generated content uses Jentic to discover GPTZero, load /predict/text, and execute with the user's submission. The X-API-Key is held in Jentic's MAXsystem vault, so the agent never sees the raw secret. The agent reasons over the returned probability and decides whether to escalate.

Use the Jentic SDK to search 'detect ai-generated text', load POST /predict/text, and execute with the user-submitted body.

Key Endpoints

7 endpoints — gptzero is an ai-text detection service used widely in education and publishing to score whether a passage was written by a human or generated by a large language model.

METHOD

PATH

DESCRIPTION

POST

/predict/text

Synchronously score a text passage for AI authorship

POST

/predict/files

Score an uploaded PDF, DOCX, or TXT document

POST

/batch

Submit a batch of documents for asynchronous scoring

GET

/batch/{batchId}

Poll batch status

GET

/batch/{batchId}/results

Retrieve per-document batch results

GET

/reports

List historical detection reports

GET

/reports/{reportId}

Retrieve a specific historical report

POST

/predict/text

Synchronously score a text passage for AI authorship

POST

/predict/files

Score an uploaded PDF, DOCX, or TXT document

POST

/batch

Submit a batch of documents for asynchronous scoring

GET

/batch/{batchId}

Poll batch status

GET

/batch/{batchId}/results

Retrieve per-document batch results

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

GPTZero's X-API-Key is stored encrypted in Jentic's MAXsystem vault. The header is injected at execution time, so the raw key never appears in agent prompts, tool outputs, or transcripts.

Intent-based discovery

Agents search Jentic with intents like 'detect ai-generated text' and Jentic returns POST /predict/text or /predict/files with their request schemas, so the agent picks the synchronous or document path without reading the spec.

Time to first call

Direct integration: half a day for key provisioning, request schema modelling, and batch polling logic. Through Jentic: under 30 minutes — the batch poll loop is wrapped in the SDK execution flow.

FAQs

Specific to using GPTZero API through Jentic.

What authentication does the GPTZero API use?

GPTZero uses an API key sent in the X-API-Key header. Generate keys in the GPTZero dashboard and rotate them per environment. Through Jentic, the X-API-Key is stored in MAXsystem and injected at execution time so the agent never handles the raw secret.

Can I score a PDF directly with this API?

Yes. POST /predict/files accepts a multipart upload of PDF, DOCX, or TXT files and returns the same scoring shape as /predict/text. GPTZero handles text extraction server-side, so the agent does not need a local PDF parser.

What are the rate limits for the GPTZero API?

The OpenAPI spec does not declare rate limits. Limits are enforced at the gateway tied to your plan tier. Free and education tiers have stricter monthly word quotas; paid tiers raise the per-minute concurrency. Cache identical text bodies to avoid duplicate spend.

How do I submit a batch of documents through Jentic?

Search Jentic for 'submit a batch of documents for ai detection', load POST /batch, and execute with the document array. Then call GET /batch/{batchId} to poll status and GET /batch/{batchId}/results to retrieve per-document scores once status is complete.

What does the per-sentence breakdown contain?

Both /predict/text and /predict/files return a sentence-level array where each entry includes the sentence text and an AI-generation probability. This lets reviewers see exactly which passages triggered the model rather than relying only on a document-level score.

Is the GPTZero API free?

GPTZero offers a free tier with limited monthly words and a paid tier with higher quotas, batch access, and priority concurrency. Education customers can apply for institution-wide pricing. Pricing is published on gptzero.me.

GPTZero API

Connect the GPTZero API to your agent

Capabilities

Start building with GPTZero API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs