About

Imported from terminalskills/skills (skills/originality-ai/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill originality-ai. Copyright stays with the author (Apache-2.0).

Originality.ai API Integration

Name: originality-ai
Author: terminalskills

Overview

Originality.ai combines AI content detection with plagiarism checking in a single API. It uses a credit-based pricing model where each scan costs credits proportional to word count.

API base URL: https://api.originality.ai/api/v1
Auth: X-OAI-API-KEY header
Docs: https://docs.originality.ai

Instructions

Authentication

Set ORIGINALITY_API_KEY in your environment. Pass it in the X-OAI-API-KEY header for all requests.

AI Detection — POST `/api/v1/scan/ai`

Send { "content": "<text>", "aiModelVersion": "1", "storeScan": false }. Returns:

score.ai (0-1) — probability of AI authorship
score.original (0-1) — probability of human authorship (equals 1 - ai)
credits_used — credits consumed by this scan

`score.ai`	Meaning
0.80 - 1.0	Very likely AI-generated
0.50 - 0.79	Mixed / uncertain
0.20 - 0.49	Probably human-written
0.00 - 0.19	Very likely human

Plagiarism Detection — POST `/api/v1/scan/plag`

Send { "content": "<text>", "storeScan": false }. Returns:

score.percentUnique (0-100) — percentage of unique content
score.percentDuplicated (0-100) — percentage matched elsewhere on the web
matches[] — array of { url, matchedWords, percentage } for each source found

Combined Scan

Run both AI detection and plagiarism checks in parallel for comprehensive content verification. Flag content if AI score >= 0.5 or plagiarism >= 20%.

Credit Management

Check your balance via GET /api/v1/account/credits/balance. Credits are consumed per word, and AI + plagiarism scans cost credits separately. Use storeScan: false to avoid storing content in the dashboard.

Examples

Example 1: Checking marketing copy for originality

A content team lead verifies a freelancer's submitted blog post about cloud migration:

AI Detection:
POST https://api.originality.ai/api/v1/scan/ai
Headers: { "X-OAI-API-KEY": "oai-key-abc123...", "Content-Type": "application/json" }
Body: { "content": "Cloud migration is a transformative journey that organizations must carefully plan. It is essential to consider the various deployment models available, including public, private, and hybrid cloud solutions. Furthermore, a comprehensive migration strategy should address data security, compliance requirements, and cost optimization.", "aiModelVersion": "1", "storeScan": false }

Response:
{ "success": true, "score": { "ai": 0.92, "original": 0.08 }, "credits_used": 1 }

Plagiarism Check:
POST https://api.originality.ai/api/v1/scan/plag
Body: { "content": "...(same text)...", "storeScan": false }

Response:
{ "success": true, "score": { "percentUnique": 73, "percentDuplicated": 27 }, "matches": [{ "url": "https://example-cloud-blog.com/migration-guide", "matchedWords": 42, "percentage": 22 }], "credits_used": 1 }

Result: Flagged — AI score 92%, plagiarism 27% duplicated.
Total credits used: 2.

Example 2: Verifying an original product review

An e-commerce site checks a customer-submitted product review:

AI Detection:
POST https://api.originality.ai/api/v1/scan/ai
Body: { "content": "I bought this blender last March after my old Vitamix finally died (RIP, 8 years of smoothies). The Ninja BN701 is louder than I expected — my cat literally bolts out of the kitchen — but it crushes frozen mango like nothing. The lid seal is a bit finicky, learned the hard way when I repainted my ceiling with acai. For $89 though, no complaints.", "aiModelVersion": "1", "storeScan": false }

Response:
{ "success": true, "score": { "ai": 0.04, "original": 0.96 }, "credits_used": 1 }

Plagiarism Check:
Response:
{ "success": true, "score": { "percentUnique": 100, "percentDuplicated": 0 }, "matches": [], "credits_used": 1 }

Result: Passes both checks — AI score 4%, 100% unique content.

Guidelines

Minimum 50 words required for AI detection
Best accuracy for English; other languages are supported but less reliable
Plagiarism check only works for publicly indexed web content
Heavily paraphrased AI text may evade detection
Does not detect AI in images, code, or structured data
Budget credits for bulk runs: estimate ~1 credit per 100 words per scan type
Handle HTTP 402 (insufficient credits) and 429 (rate limited) gracefully
Always pair automated detection with human review for final decisions

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-originality-ai/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-originality-ai.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-originality-ai",
  "kind": "skill",
  "name": "originality-ai",
  "description": "Use Originality.ai API to detect AI-generated content and check for plagiarism simultaneously. Use when: SEO content audits, freelancer content verification, editorial review pipelines, originality checks.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding",
      "marketing"
    ],
    "tags": [
      "skill-md",
      "ai-detection",
      "plagiarism",
      "originality",
      "content-moderation",
      "seo",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use Originality.ai API to detect AI-generated content and check for plagiarism simultaneously. Use when: SEO content audits, freelancer content verification, editorial review pipelines, originality checks."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/originality-ai/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/originality-ai/SKILL.md",
      "key": "terminalskills/skills/skills/originality-ai/SKILL.md"
    },
    "compatibility": "Requires Node.js 18+ or Python 3.9+",
    "license": "Apache-2.0"
  },
  "instructions": "# Originality.ai API Integration\n\n## Overview\n\nOriginality.ai combines AI content detection with plagiarism checking in a single API. It uses a credit-based pricing model where each scan costs credits proportional to word count.\n\n- **API base URL:** `https://api.originality.ai/api/v1`\n- **Auth:** `X-OAI-API-KEY` header\n- **Docs:** https://docs.originality.ai\n\n## Instructions\n\n### Authentication\n\nSet `ORIGINALITY_API_KEY` in your environment. Pass it in the `X-OAI-API-KEY` header for all requests.\n\n### AI Detection — POST `/api/v1/scan/ai`\n\nSend `{ \"content\": \"<text>\", \"aiModelVersion\": \"1\", \"s",
  "cost": {
    "context_tokens": 1120
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-originality-ai/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.