API Integration Guide

Wise AI lets you extract vital signs, heart rate and respiratory rate, from a required 60-second video of a person's face. Just send us the video, and we'll return the results in seconds.

Choose Mode

Endpoint

POST https://api.wiseai.store/process-video

Authentication

Every request needs an API key passed via the X-API-Key header. Don't have one yet? Reach out to us at contact@wiseai.care to get your API key today.

Normal Mode: Making a Request

Send your full 60-second video as a multipart form upload with the field name file:

curl -X POST https://api.wiseai.store/process-video \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@video.mp4;type=video/mp4"

Normal Mode: Recommended Video Procedure

  1. Ask the subject to face the camera directly with even lighting on the face.
  2. Frame the shot to include the full face and upper chest (important for breathing rate).
  3. Keep the camera stable and record a full 60-second clip with minimal talking or movement.
  4. Export/upload in standard MP4 format and avoid heavy compression.
  5. Submit via the file form field and review confidence scores in the response.

Normal Mode: Response

You'll get back a JSON object with both vitals, each paired with a confidence score (0 to 1):

{
  "heart_rate": {
    "value": 75.84,
    "confidence": 0.88
  },
  "respiratory_rate": {
    "value": 17.57,
    "confidence": 0.97
  }
}

Field Description

  • heart_rate.value — Estimated heart rate in BPM
  • heart_rate.confidence — Model confidence for the reading
  • respiratory_rate.value — Estimated breaths per minute
  • respiratory_rate.confidence — Model confidence for the reading

Tips for Best Results

Lighting environment

  • Use even illumination across the face and avoid strong side shadows.
  • Avoid flickering light sources and rapidly changing screen light.

Video quality

  • Prefer clear, higher-bitrate video over heavily compressed clips.
  • You do not need 4K; a clean, stable video is usually better.

Motion and positioning

  • Keep the subject mostly still; normal blinking is fine, but large movement reduces reliability.
  • For respiratory rate, include face + upper chest in frame; face-only is often enough for heart rate.

Validate with confidence

  • Use returned confidence values to flag low-quality captures for retake.

Questions or Need Help?

Questions or need help integrating? Contact us at contact@wiseai.care.

Further Reading (rPPG)