1. Get your API key
Log in to the HumanStandard dashboard and go to Settings → API Keys. Create a key and copy it — it’s shown once.
Keep your API key secret. Use environment variables, not hardcoded values.
2. Analyze a track
POST a publicly accessible audio URL:
curl -X POST https://app.jobsbyhumans.com/api/v1/analyze \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://your-cdn.com/track.mp3"}'
3. Act on the result
Route based on tier_verdicts:
tier = result.get("tier_verdicts") or {}
if tier.get("human_safe") == "suspicious":
# Reject — high-confidence AI
elif tier.get("recall") == "suspicious":
# Send to manual review — borderline
else:
# Approve
Use tier_verdicts for routing, not the top-level verdict. Each tier is calibrated to a specific false positive rate. See Confidence Tiers.
Next steps