AI detection API for text and images: one POST, one GET, a score you can act on

POST /api/v1/enterprise/detect

Submit text for analysis. Returns immediately with a job handle and the credit usage for the submission. Body is { "text": "string" }, between 50 and 10,000 characters.

GET /api/v1/enterprise/detect/{request_id}

Fetch the result. Append ?wait=true and the server holds the connection open until the job completes, up to roughly 30 seconds, which removes the need for a polling loop in most integrations.

# 1. Submit text for analysis
curl -X POST "https://detector-api-server-tsxmk.ondigitalocean.app/api/v1/enterprise/detect" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"text": "Paste between 50 and 10,000 characters of the text you want analysed."}'

# → { "request_id": "ent_a3f9b2c1d4e5", "status": "queued", "usage": { ... } }

# 2. Fetch the result. ?wait=true long-polls until the job completes.
curl "https://detector-api-server-tsxmk.ondigitalocean.app/api/v1/enterprise/detect/ent_a3f9b2c1d4e5?wait=true" \
  -H "X-API-Key: YOUR_API_KEY"

The result payload

{
  "status": "completed",
  "job_id": "ent_a3f9b2c1d4e5",
  "document_score": 82,
  "document_prediction": "AI",
  "document_probability": 0.82,
  "total_sentences": 14,
  "processing_time": 340,
  "sample_sentences": [
    { "sentence": "Furthermore, the results demonstrate...", "score": 91 },
    { "sentence": "This analysis shows...",                  "score": 78 }
  ]
}

POST /api/v1/enterprise/detect

Upload one image as multipart/form-data in a field named file, with the same X-API-Key header. Supported formats are JPG/JPEG, PNG, WebP, BMP, TIFF and HEIC/HEIF. The file type is read from the file name, so keep the real extension (photo.heic, not upload). Each key can submit one image per minute. The response is a job_id, or the finished result when the image is processed at once.

GET /api/v1/enterprise/detect/{job_id}

Fetch the result. With ?wait=true the server holds the request for up to about 25 seconds. Repeat the call until result is filled in or error is set.

# 1. Upload an image
curl -X POST "https://image-detector-hesvs.ondigitalocean.app/api/v1/enterprise/detect" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg"

# → { "job_id": "3f6c1a9e...", "status": "queued" }

# 2. Fetch the result. ?wait=true holds the request until the job finishes.
curl "https://image-detector-hesvs.ondigitalocean.app/api/v1/enterprise/detect/JOB_ID?wait=true" \
  -H "X-API-Key: YOUR_API_KEY"

The image result payload

{
  "job_id": "3f6c1a9e2b7d4c58",
  "status": "completed",
  "result": {
    "label": "AI",
    "is_ai": true,
    "ai_probability": 94.6,
    "generator": "Midjourney",
    "detection_step": 2,
    "step": "ml_model",
    "metadata": { "prediction": "inconclusive", "detail": "No camera EXIF found", "ai_probability": null },
    "ml_model": { "prediction": "ai", "detail": "Generator fingerprint matched", "ai_probability": 94.6 },
    "elapsed_ms": 1840,
    "credits_consumed": 2000,
    "credits_remaining": 2998000
  },
  "error": null
}

Keep your key server-side. It is a bearer credential in a header, so anything that can read it can spend your credits. If one leaks, regenerate it from the dashboard: the old secret stops working immediately and your balance carries over.