Guide
API Reference
SDKs
Reference

Getting Started

The Qualia Relationship Intelligence API is the emotional intelligence API for AI agents. It gives any agent the ability to understand who it's communicating with — including their communication style — and adapt accordingly. One call gives you a full communication profile: archetype, strategy array, and behavioral dimensions.

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

Step 1 — Get your API key

Go to /settingsAPI 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.qualia.ai/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", communication_strategy: ["data_first", ...], dimensions: { openness: 85, conscientiousness: 82, ... } }

Step 3 — Adapt a message

curl -X POST https://api.qualia.ai/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 strategy: data_first, logical_structure, recommendation_last

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 sandboxhttps://qualia-for-devs-qewv2oaa7q-uc.a.run.app/api/v1/context/person
Using demo key — add your own for full results