Start Here
Guide
API Reference
SDKs
Reference

Getting Started

The Qualia Recipient Intelligence API gives any AI agent the ability to understand who it's communicating with — including their communication style — and adapt accordingly. One call gives you a full recipient profile: archetype, communication guidance, and confidence signals.

🎁 Free sandbox keys include 500 credits — no credit card required.

Step 1 — Get your API key

Go to DashboardAPI Keys and create a sandbox key. It looks like qua_sb_....

Step 2 — Make your first call

# Profile a person from sample text curl -X POST https://api.qualiaai.co/api/v1/context/person \ -H "X-Qualia-Key: qua_sb_your_key" \ -H "Content-Type: application/json" \ -d '{' "email": "sarah@acme.com", "sample_text": "I need to review the data before we decide." '} ' # → { archetype: "Sphinx", guidance: { summary: "..." }, confidence: 0.8 }

Step 3 — Adapt a message

curl -X POST https://api.qualiaai.co/api/v1/adapt/message \ -H "X-Qualia-Key: qua_sb_your_key" \ -H "Content-Type: application/json" \ -d '{' "recipient_id": "per_9f2b1f7a", "channel": "email", "intent": "request", "message": "Can you send the forecast by Friday?" '} '

Or use the CLI

npm install -g @qualia/cli qualia auth login --key qua_sb_your_key qualia context person --email sarah@acme.com --text "I need to review the data first." # → archetype: Sphinx guidance: leads with data and analysis

Try it live

Run a real /context/person call right here. Paste any text snippet and hit Run — results appear instantly. Leave the API key blank to use the read-only demo key.

Live sandbox/api/v1/context/person
Using demo key — add your own for full results