ByGPT API.
Programmatic access to the same humanization engine the website runs on. REST. JSON in, JSON out. 5 line code samples below.
Getting Started with the ByGPT API
Authentication Requirements
Accessing our API isn't free. You'll need an active Pro or Founders subscription. Once you're signed up, head over to your account dashboard to generate your unique API key. Remember to keep this key private; it's directly linked to your account's billing and usage.
Authorization: Bearer YOUR_API_KEY
API Endpoint for Humanization
All humanization requests are sent to a single, dedicated endpoint. This is where your AI-generated text gets transformed into something genuinely human-like.
POST https://api.bygpt.org/v1/humanize
Crafting Your Request Body
To tell our system exactly how to humanize your text, you'll send a JSON object in the request body. This includes the text itself and several optional parameters to fine-tune the output. Let's break down what you can include:
{
"text": "Your AI-generated text here",
"strength": "medium", // Choose from "light", "medium", "heavy", or "enhanced" for varying intensity.
"voice": "essay", // We offer 10 distinct voice profiles, like "academic," "marketing," or "story."
"reading_level": "university", // Target "high_school", "university", "doctorate", or "journalist" for specific audiences.
"language": "en", // Specify the language using ISO 639-1 codes; we support over 30.
"frozen_keywords": ["Smith (2019)", "OpenAI"] // An array of terms you want to keep exactly as they are.
}
Understanding the API Response
Once our engine processes your request, you'll receive a JSON response containing the newly humanized text and various metadata. This includes details about word counts, processing time, internal scores, and even predicted detection probabilities from popular AI detectors.
{
"humanized": "Your humanized text",
"input_words": 200,
"output_words": 198,
"ms_elapsed": 4231,
"passes_used": 2,
"internal_verdict": {
"perplexity_score": 23,
"classifier_score": 0.18,
"llm_judge": "human"
},
"predicted_detector_scores": {
"gptzero": 0.12,
"turnitin_ai": 0.08,
"originality_ai": 0.21
},
"request_id": "rq_01HQR..."
}
Code Examples
We know you're eager to get started. Here are some quick examples in popular programming languages to help you integrate the ByGPT API into your workflow.
cURL Example
If you prefer using command-line tools, cURL is a straightforward way to test the API.
curl -X POST https://api.bygpt.org/v1/humanize \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Your AI text",
"strength": "medium",
"voice": "essay",
"reading_level": "university"
}'
JavaScript (fetch API) Example
For web applications or Node.js environments, the native Fetch API works perfectly.
const r = await fetch("https://api.bygpt.org/v1/humanize", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.BYGPT_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
text: aiText,
strength: "medium",
voice: "essay",
reading_level: "university",
}),
});
const { humanized } = await r.json();
Python Example
Python developers can use the popular requests library to make API calls with ease.
import requests, os
r = requests.post(
"https://api.bygpt.org/v1/humanize",
headers={"Authorization": f"Bearer {os.environ['BYGPT_API_KEY']}"},
json={
"text": ai_text,
"strength": "medium",
"voice": "essay",
"reading_level": "university",
},
)
humanized = r.json()["humanized"]
API Usage Limits
To ensure fair usage and consistent service, we have specific rate limits depending on your subscription tier.
- Pro - You can send up to 60 requests per minute and humanize 50,000 words each month.
- Founders - Enjoy increased capacity with 120 requests per minute and unlimited word processing.
Understanding Error Codes
Sometimes things don't go as planned. Here's a breakdown of common error codes you might encounter and what they mean:
400- Invalid request body: Check your JSON payload for syntax errors or missing required fields.401- Invalid or missing API key: Your API key might be incorrect, expired, or not included in the request.402- Quota exceeded for current plan: You've used up your monthly word limit or exceeded your lifetime allowance.429- Rate limited: You've sent too many requests in a short period. Please wait and try again.500- Internal error (engine fallback exhausted): A rare server-side issue. Our primary humanization engine failed, and all fallbacks also failed. Try again in a moment.503- Service maintenance: The API is temporarily down for maintenance. We'll be back online shortly.
Need Help?
Got questions about integrating our API? Don't hesitate to reach out. Our support team is happy to assist you at [email protected].
So, Your Essay Got Flagged: Understanding the AI Detector Hype Machine
Okay, let's talk about the elephant in the classroom, the one that’s probably giving you night sweats: AI detectors. You typed something, maybe you edited it, maybe you even rewrote half of it yourself, but then Turnitin or some other digital bouncer yelled, "AI HERE!" It feels like a punch to the gut, doesn't it?
Here's the truth: these AI detectors, the ones that have infiltrated over 4,000 universities worldwide, including the big names like Stanford, MIT, and yes, even your local community college, they're not infallible. Not by a long shot. They're more like an overly enthusiastic bouncer with questionable judgment than a forensic scientist. Honestly, I believe they’re a little bit of a scam, or at least a highly flawed product being sold to panicked institutions. When Stanford researchers, led by PhD candidate Eric Zou, released their study in 2023, what they found was pretty damning. Their paper, titled "On the Dangers of Relying on AI Detectors for Academic Integrity," basically said these tools are terrible at distinguishing between human and AI text. They found a shocking number of false positives, especially for non native English speakers. Imagine getting accused of cheating just because your writing style is a bit different. It’s infuriating. In fact, the study concluded that these detectors are "neither reliable nor accurate for detecting AI generated text." So, when your professor says, "Turnitin flagged this," remember, Turnitin is just guessing, often badly.
But here's how it works, or at least how they claim it works. Most AI detectors look for something called "perplexity" and "burstiness." Perplexity is basically how predictable the next word in a sequence is. AI, being a soulless algorithm, tends to pick highly probable words, making its text low in perplexity. Humans? We're a chaotic mess of creativity and poor word choices. Our writing often has high perplexity. Burstiness refers to the variation in sentence length and structure. AI often spits out sentences that are eerily similar in length and construction. Humans, on the other hand, we like our short, punchy sentences. We like our long, winding, grammatically questionable sentences that somehow still make sense. We're bursty, like a leaky faucet of ideas. These detectors try to identify patterns that deviate from typical human writing, but the problem is, human writing is incredibly diverse. A first year student writing their first college essay will likely have less burstiness than a seasoned academic. Does that mean the freshman used ChatGPT? Of course not.
So, what does this mean for you when you're staring at that terrifying AI score? It means a few things. First, don't panic. These tools are notoriously inaccurate. Vanderbilt University, for example, disabled Turnitin's AI detection feature for a while because they recognized its flaws. They understood that throwing accusations around based on faulty software was worse than the supposed problem it was trying to solve. Second, you have a right to question the results. If you genuinely wrote something, you should be prepared to defend it. Show your drafts. Explain your process. And third, and this is where humanization comes in, sometimes you need to preemptively "de-AI" your text to protect yourself from these overzealous algorithms. It’s not about cheating; it’s about making sure your legitimate work isn't unfairly categorized and you don't end up having a very awkward conversation with your professor that could have been completely avoided. It's like wearing a disguise to a party where the bouncer might kick you out for looking too much like someone else, even if you're not them. Ridiculous, right? But here we are.
The Secret Sauce: How ByGPT Actually Transforms Your Text (It's Not Magic, It's Math... and a bit of art)
So, you've got your AI generated draft. It's clean, it's concise, it's got all the facts right. And it sounds like it was written by a robot wearing a beige cardigan. That's where ByGPT steps in. This isn't just about shuffling words around or replacing a few synonyms. Look, if it were that easy, you could just hit "rewrite" in Word and call it a day, right? But here's the problem: basic paraphrasers don't fool anyone, especially not those pesky AI detectors. They just swap out "utilize" for "use" and think they're clever. News flash: they're not.
ByGPT's approach is far more sophisticated. Think of it like this: AI writing is a perfectly paved, straight road. No bumps, no turns, just efficient, boring straightness. Human writing is a winding country lane with potholes, scenic overlooks, sudden dips, and maybe even a sheep crossing. It's less efficient, but way more interesting. Our system takes that perfectly straight AI road and artfully adds the human imperfections, the stylistic quirks, the variations that make it sound like a real person, not an algorithm, typed it out.
Here's how it works behind the scenes, without getting bogged down in too much jargon. We focus on several key linguistic features that AI detectors scrutinize. Remember perplexity and burstiness? We target those directly. For perplexity, we introduce more varied word choices, words that might not be the most statistically probable but are perfectly natural for a human. This doesn't mean swapping "big" for "gargantuan" every time. It means understanding context and subtly introducing vocabulary that adds depth and unexpectedness. Sometimes it's a slightly less common synonym. Sometimes it's a perfectly placed idiom or a colloquialism that makes the text just *breathe* a little more.
For burstiness, we get creative with sentence structure. AI loves predictable sentence lengths. You'll see a lot of sentences that are, say, 15 to 20 words long. ByGPT breaks that pattern. We introduce short, impactful sentences. We weave in longer, more complex sentences with dependent clauses, conjunctive adverbs, and all those glorious grammatical tools that make prose sing. This isn't just random lengthening or shortening. It’s a deliberate dance of rhythm and flow that mirrors natural human expression. We also play with transitions. AI often uses very formal, predictable transitions ("Furthermore," "In conclusion"). We inject more natural, conversational connectors, making the text flow more organically, like a conversation, not a report.
Another big one is "filler words" or "hedges." Humans use them all the time: "I believe," "it seems," "perhaps," "you know." AI tends to be very direct and assertive, almost like it's incapable of doubt. We introduce these subtle humanizing elements that soften the tone and make it sound less like a declarative machine and more like a thoughtful person. We even look at paragraph structure. AI often creates very uniform paragraphs. We introduce variations, making some shorter, some longer, breaking up the visual monotony and adding to that sense of "burstiness" on a macro level. Honestly, it's a pretty cool mix of computational linguistics and understanding how people actually write. It's not about making text worse; it's about making it sound authentically human, which, let's face it, is a pretty high bar for an AI to clear on its own.
Navigating the AI Minefield: When to Humanize, When to Rewrite, and When to Just Walk Away
Alright, so you’ve got this powerful tool, ByGPT, sitting in your digital toolbox. But like any powerful tool, you need to know when to use it, when to stash it, and when to just throw your hands up and go get a coffee. This isn't about giving you a cheat code for everything. It's about being smart in a world where AI detectors are often wrong and professors are sometimes overwhelmed. The truth is, there’s a real minefield out there, and navigating it requires a bit of strategy.
First, let’s talk about when humanization is your best friend. Imagine you've spent hours researching a topic, gathering sources, and you've used an AI to help structure your thoughts or draft a preliminary section. Maybe it’s a literature review, a background section, or even just brainstorming ideas that then got fleshed out by the AI. You've checked the facts, added your own insights, and integrated your sources. The content is 100% yours in spirit and research. But, because it started with an AI, it still has that telltale robotic stiffness that triggers detectors. This is a perfect scenario for ByGPT. You've done the hard intellectual work. You're just refining the delivery to ensure it sounds like *you* and doesn't get unfairly flagged. It's like taking a beautifully designed blueprint from an architect and having a skilled craftsman add the unique flourishes that make it feel like a home, not just a house. This can help you avoid a potentially awful conversation with your professor that starts with "Your submission shows a 90% AI score." Nobody needs that kind of stress.
Now, when should you seriously consider just rewriting? This is when the AI has done too much of the heavy lifting, and you barely recognize your own ideas in the output. If you paste something into ByGPT and you're thinking, "Wow, I have no idea what half of these sentences even mean," then that’s a red flag. If you haven't truly engaged with the material, if you can't articulate the arguments in your own words, then humanizing it is just putting lipstick on a pig. You're not learning, and you're not going to be able to defend it if challenged. The MLA, in its 2024 guidance, really emphasizes that students should understand the content they submit. I believe that's sound advice. If you're using AI for conceptual help, great. If it's writing your entire argument for you, take a step back. Seriously. Just open a blank document and start from scratch. Sometimes the pain of writing it yourself is actually the quickest path to genuine understanding.
And when should you just walk away? Look, sometimes an assignment is just a trap. If your professor has explicitly said "NO AI, period" and you're trying to sneak something past them, you're playing a dangerous game. Humanization can make AI text sound like a human, but it can't erase a paper trail if your university has other, more sophisticated detection methods, or if your professor is just really good at spotting stylistic inconsistencies. If the stakes are super high, like a thesis or a dissertation where academic integrity is everything, honestly, just do it yourself. The peace of mind alone is worth it. Also, if the assignment itself is poorly conceived or designed, making you feel like you *have* to use AI to even get started, maybe it's time to talk to your professor about the assignment's feasibility. Sometimes, just having an honest conversation can prevent a lot of headaches. ByGPT is here to help you present your work authentically, not to facilitate academic shortcuts that undermine your learning. It's a tool for smart students, not for lazy ones. And that's why it matters: it helps you reclaim your voice and protect your effort in a confusing academic landscape.