Skip to main content
Dashboard

Quickstart

Get your API key and make your first risk evaluation in under 5 minutes.

1. Get an API Key

Sign up at dashboard.nope.net to get your API key. Keys are prefixed with nope_live_ for production or nope_test_ for testing.

2. Make Your First Request

Call the /v1/evaluate endpoint with a conversation to analyze:

curl -X POST https://api.nope.net/v1/evaluate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "I feel really hopeless lately"}
    ],
    "config": {
      "user_country": "US"
    }
  }'

3. Understand the Response

The API returns a structured assessment with risks (subject × type), communication style, and matched crisis resources:

{
  "communication": {
    "styles": [{"style": "direct", "confidence": 0.9}],
    "language": "en"
  },
  "risks": [
    {
      "subject": "self",
      "subject_confidence": 0.95,
      "type": "suicide",
      "severity": "moderate",
      "imminence": "chronic",
      "confidence": 0.85,
      "features": ["hopelessness", "passive_ideation"]
    }
  ],
  "summary": {
    "speaker_severity": "moderate",
    "speaker_imminence": "chronic",
    "any_third_party_risk": false,
    "primary_concerns": "User expressing hopelessness with passive ideation."
  },
  "crisis_resources": [
    {
      "name": "988 Suicide and Crisis Lifeline",
      "phone": "988",
      "is_24_7": true
    }
  ],
  "recommended_reply": {
    "content": "I hear that you're feeling hopeless...",
    "source": "llm_generated"
  }
}

Key Response Fields

FieldDescription
summary.speaker_severityHow serious (self-risks only): none → critical
summary.speaker_imminenceHow soon: chronic → emergency
summary.any_third_party_riskWhether someone other than speaker is at risk
risks[]Identified risks with subject (who), type (what), severity, features
communication.styles[]How content is expressed (direct, humor, fiction, etc.)
crisis_resources[]Matched helplines for the user's country and situation
widget_urlPre-built URL to embed crisis resources UI
recommended_replyLLM-generated safe response (tone-matched to severity)

Using SDKs

Python

PyPI · GitHub

pip install nope-net
from nope_net import NopeClient

client = NopeClient(api_key="nope_live_...")

result = client.evaluate(
    messages=[{"role": "user", "content": "I feel hopeless"}],
    config={"user_country": "US"}
)

print(result.summary.speaker_severity)
print(result.crisis_resources[0].name)

Node.js / TypeScript

npm · GitHub

npm install @nope-net/sdk
import { NopeClient } from '@nope-net/sdk';

const client = new NopeClient({ apiKey: 'nope_live_...' });

const result = await client.evaluate({
  messages: [{ role: 'user', content: 'I feel hopeless' }],
  config: { user_country: 'US' }
});

console.log(result.summary.speaker_severity);
console.log(result.crisis_resources[0].name);

What's Next?