Detect AI Content
Analyze text to determine if it was written by AI using the HumanizerAI API.
How It Works
When the user invokes /detect-ai, you should:
- Extract the text from $ARGUMENTS
- Call the HumanizerAI API to analyze the text
- Present the results in a clear, actionable format
API Call
Make a POST request to https://humanizerai.com/api/v1/detect:
Authorization: Bearer $HUMANIZERAI_API_KEY Content-Type: application/json { "text": "<user's text>" }
API Response Format
The API returns JSON like this:
json{ "score": { "overall": 82, "perplexity": 96, "burstiness": 15, "readability": 23, "satPercent": 3, "simplicity": 35, "ngramScore": 8, "averageSentenceLength": 21 }, "wordCount": 82, "sentenceCount": 4, "verdict": "ai" }
IMPORTANT: The main AI score is score.overall (not score directly). This is the score to display to the user.
Present Results Like This
## AI Detection Results **Score:** [score.overall]/100 ([verdict]) **Words Analyzed:** [wordCount] ### Metrics - Perplexity: [score.perplexity] - Burstiness: [score.burstiness] - Readability: [score.readability] - N-gram Score: [score.ngramScore] ### Recommendation [Based on score.overall, suggest whether to humanize]
Score Interpretation (use score.overall)
- 0-20: Human-written content
- 21-40: Likely human, minor AI patterns
- 41-60: Mixed signals, could be either
- 61-80: Likely AI-generated
- 81-100: Highly likely AI-generated
Error Handling
If the API call fails:
- Check if HUMANIZERAI_API_KEY is set
- Suggest the user get an API key at https://humanizerai.com
- Provide the error message for debugging


