Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Alejandrin08/Hackathon-SPEI/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is served by the AI service at http://localhost:8001. It is an internal service and does not require authentication.

​
POST /ai/accessibility

Called during the onboarding accessibility wizard to recommend the best UI theme and settings for the user. The model takes behavioral and self-reported signals and returns a tailored accessibility profile.
Model accuracy: 0.89.

​
Request body

​
can_read_small_text
boolean
required
Whether the user can comfortably read small text.
​
uses_screen_reader
boolean
required
Whether the user relies on a screen reader.
​
feels_confident_with_apps
string
required
Self-reported confidence level with mobile apps. Accepted values: "low", "medium", "high".
​
age_range
string
required
User’s age bracket. Accepted values: "18_30", "31_50", "51_60", "60_plus".
​
avg_time_per_screen_seconds
integer
required
Average time the user spends per screen during the session. Must be ≥ 0.
​
total_validation_errors
integer
required
Total number of validation errors across the session. Must be ≥ 0.
​
requested_help_count
integer
required
Number of times the user explicitly requested help during the session. Must be ≥ 0.
​
user_id
string
Optional user identifier for logging and analytics.

​
Response

​
user_id
string
Echoed user identifier from the request.
​
model_version
string
required
Version of the accessibility model that produced the recommendation.
​
recommendation
object
required
​
confidence
number
required
Model confidence score between 0.0 and 1.0.
​
explanation
string[]
required
Human-readable list of reasons for the recommendation.

​
Theme values

ThemeDescriptionFont scale
standard-accessibleDefault accessible mode for most users.1.2
large-text-high-contrastFor low vision or older users who need increased readability.1.6
voice-assistedFor screen reader users. Enables voice feedback.1.2
curl --request POST \
  --url http://localhost:8001/ai/accessibility \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "user-123",
  "can_read_small_text": false,
  "uses_screen_reader": false,
  "feels_confident_with_apps": "low",
  "age_range": "60_plus",
  "avg_time_per_screen_seconds": 45,
  "total_validation_errors": 6,
  "requested_help_count": 2
}'
Response
{
  "user_id": "user-123",
  "model_version": "accessibility-v1.1",
  "recommendation": {
    "theme": "large-text-high-contrast",
    "screen_reader_mode": false,
    "font_scale": 1.6,
    "nudging_level": "high",
    "voice_feedback": false
  },
  "confidence": 0.9,
  "explanation": ["Increased font and contrast for readability"]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us