Originality.ai API Documentation and Guide

## Sections
• [Originality.ai API V3 Documentation and Instructions](https://docs.originality.ai/originality-ai-api-v1.md): Important Model Update As we have communicated via email to existing API users, we have fully mapped the previous AI Detection models to our AI Allowance system. As a user of our API this means we have automatically mapped selected models to our AI Allowance system. Please refer to the table below for the mappings (across API V1, V2 & V3). If you are a multi language model user, no changes have been made. Title Description Model Allowance Threshold Lite 1.0.0 15% Lite 1.0.2 15% Turbo 5% Academic 15% Multilange No Change. Explore our guides and examples to integrate Originality.ai into your workflows 1 First step Create or Login to Originality.ai and subscribe to our Enterprise level plan 2 Create API Key Create an api key for use here: https://app.originality.ai/home/api-token-dashboard 3 Prepare Requests All requests must contain the following header Key Value X-OAI-API-KEY your-api-key Important Information Rate Limit The rate limit for our api is 500 requests per minute. Your remaining limit for the current minute can be found by examining the response headers after a request has completed. In the event you have reached the upper limit, a 429 “too many requests” error will be returned by our system Auto Credit Top-up By default, Originality.ai accounts are set to automatically top up credits when they fall low. This means that if you've exhausted your originality.ai credits while using the api, credits will be automatically purchased using your default payment method on file. This is to ensure smooth operating of your workflows. You can manage your top up settings anytime here: https://app.originality.ai/home/account#topup Tips to avoid unwanted credit card charges Title a) Reduce request concurrency b) Adjust Auto top up settings (disable, +/- threshold) c) Manually purchase credits - https://app.originality.ai/home/credits/purchase Scan Features This page outlines the scan features you can use to check your content AI Allowance AI Allowance lets you choose how much AI-generated text you will allow in a document. Instead of treating all AI use as "bad," you set a limit (like 0%, 5%, 15%, 25%, or 40%). The tool then scans your text and scores it based on your specific rule. Think of it like setting a speed limit. If you set your AI allowance to 15%, the tool will check if the amount of AI-written text is 15% or less. If it is, the text passes. Here are the standard allowance levels available for use: Title Description 0% (Very Strict): Zero-tolerance for AI usage 5% (Strict): Minimal AI allowed 15% (Moderate): Some AI allowed (like light grammar corrections) 25% (Flexible): Mostly human writing with some AI-assisted help. 40% (Generous): Hybrid content is allowed, but it cannot be fully AI-generated AI Checker For the most accurate scoring provide plain text into the api when initiating a new scan. As of August 25th, 2026, the AI Checker models have been mapped to an AI all Models Title Description Title Description Version AI Allowance Threshold Mapping String for Scan Request Description Tags Lite - 1.0.0 15% “lite” Under 1% False Positive rate. Use when you want to allow some use of AI for editing. Best for academia. Lightly AI-edited content is acceptable Turbo - 3.0.2 5% “turbo” Under 5% False Positive rate. most accurate AI detector that is very hard to bypass. Use when you want to be certain AI was not used. Learn more . Effective on the latest LLMs including GPT-4o, ChatGPT, Gemini Pro, Claude 3 and popular open-source models such as Llama 3. Multi-Language No mapping “multilang” Our standard model that supports languages other than English. https://originality.ai/blog/multilanguage-ai-detection Lite - 1.0.2 15% “lite-102” Latest Beta Version of the Lite Model Lightly AI-edited content is acceptable Academic 0.0.5 15% “academic” Ideal for teachers and students Plagiarism Checker Use our plagiarism features to protect your reputation & improve your content quality by accurately detecting plagiarism content. Our plagiarism feature uses advanced machine learning to accurately detect plagiarism. It is designed to detect complex forms of plagiarism such as patchwork, unintentional, mosaic plagiarism and more! When enabling this feature on a new scan request, it will extend the length of time it takes to get a response from the API. Depending on the size of content submitted, it could take up to 60 seconds to process. If you are experiencing timeouts when running a plagiarism check you can split the content into multiple chunks and run them separately. Readability Checker Use our readability feature to help ensure that your writing isn't too complex for your readers. By giving you an approximate grade level / score, you can ensure that your content is easily understood by your target audience and they're getting the most value possible out of the information you're sharing Grammar & Spelling Checker Use our Grammar checker to check for any grammatical, spelling, and punctuation errors. Regardless of what you are writing, you have to make sure your piece is without any mistakes. Fact Checker: Our Automated Fact-Checker verifies your content in real time, flagging potential inaccuracies and providing clear justifications with trusted source links. Designed for publishers, agencies, and writers, it helps you maintain impeccable credibility in an era of evolving AI-generated text.
• [How to Run an Originality.ai API Scan](https://docs.originality.ai/scan.md): Run a new scan on your content. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization
• [How to Run a Batch Scan With the Originality.ai API](https://docs.originality.ai/batch-scan-1.md): Scan multiple pieces of content for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling
• [Originality.ai API Scan URL Instructions](https://docs.originality.ai/scan-url.md): Run a new scan on a url. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization
• [Originality.ai Credit Balance Instructions via API](https://docs.originality.ai/credit-balance-copy-1.md): Use this endpoint to return the number of base & subscription credits remaining. You can purchase more within the application here
• [How to Fetch Scan Results With the Originality.ai API](https://docs.originality.ai/scan-results-copy-1.md): Use this endpoint to fetch the results of a single scan by id Text/link results in the example below are formatted with symbols converted to character code. Results returned by the actual api are plain text