Output Scores
POST /predict returns a PredictResponse with eight fields. All scores are on a 0–100 scale and are population-normalized for the user's demographic group.
Cognitive scores
C_SCORE: Composite Cognitive Score
The headline metric. A weighted composite of attention, memory, and reasoning, calibrated to reflect overall cognitive readiness. Use this as the primary signal when a single number is needed.
attention
Predicted capacity for sustained, focused attention. A high attention score indicates the user is likely to maintain concentration on demanding tasks. A low score may indicate heightened distractibility.
memory
Predicted working memory performance. Reflects the ability to hold and manipulate information in short-term memory.
Relevant for tasks that require mental juggling, multi-step reasoning, reading comprehension and programming.
reasoning
Predicted logical and abstract reasoning ability. Reflects higher-order thinking such as planning, problem solving, and inference.
Stress
stress
Predicted physiological stress level. Higher values indicate more stress, making this the one metric where lower is better.
This metrics represents a mental stress level, which is influenced by but not identical to physical stress. For example, a user who had an intense workout may have elevated stress due to physical exertion, even if they feel mentally calm. Conversely, a user under psychological pressure may have high stress without significant physical activity.
Emotional scores
valence
Predicted emotional valence, the positive/negative dimension of mood. A "High" score indicates a positive emotional tone while a "Low" score indicates a more negative tone.
arousal
Predicted emotional arousal, the activated/deactivated dimension of mood. An "High" arousal means energized or agitated while a "Low" arousal means calm or lethargic. Combined with valence, this provides a two-dimensional emotional state picture.
Inference metadata
inference_time_ms
The time in milliseconds the model took to generate the prediction. Useful for latency monitoring in production.
Mental Score interpretation guide
| Range | General interpretation |
|---|---|
| 0–30 | Low / below average |
| 30–45 | Slightly below average |
| 45–55 | Average |
| 55–70 | Above average |
| 70–100 | High / well above average |
These bands are approximate. Individual variation is significant, which is why providing past_sessions and past_targets for personalized context is recommended.
Emotional Score interpretation guide
| Valence | Arousal | Interpretation |
|---|---|---|
| High | High | Positive and energized mood (e.g. excited, happy) |
| High | Low | Positive but calm mood (e.g. content, relaxed) |
| Low | High | Negative but energized mood (e.g. anxious, angry) |
| Low | Low | Negative and calm mood (e.g. sad, fatigued) |