API Reference

The Doolittle Engine exposes a FastAPI service for multimodal animal signal analysis. All endpoints accept standard HTTP or WebSocket connections.

Base URL: https://api.aivet.dev
POST/api/v1/doolittle/analyze/vision

Analyze image for pain/grimace indicators. Accepts JPEG/PNG. Returns pain probability, grimace score, and species-specific assessment.

Parameters

  • image_file (file)
  • species (string)
  • vision_mode: local_only | cloud_only | hybrid
  • output_format: full | summary | clinical | doolittle
POST/api/v1/doolittle/analyze/audio

Analyze audio for vocalization and respiratory patterns. Accepts WAV/MP3/WebM. Returns distress classification and spectral features.

Parameters

  • audio_file (file)
  • species (string)
  • audio_mode: local_only | cloud_only | hybrid
  • sample_rate (int, default 22050)
POST/api/v1/doolittle/analyze/fused

Full multimodal fusion. Combines vision + audio with Bayesian triage. Returns unified pain probability and triage level.

Parameters

  • image_file (file, optional)
  • audio_file (file, optional)
  • species (string)
  • output_format (string)
WS/api/v1/doolittle/stream/{session_id}

WebSocket for real-time streaming analysis. Send base64 frames/audio, receive continuous results.

Parameters

  • frame: {type: "frame", data: "<base64>"}
  • audio: {type: "audio", data: "<base64>"}
  • multimodal: {type: "multimodal", image: "<b64>", audio: "<b64>"}
POST/api/v1/doolittle/session/start

Start a monitoring session. Enables running averages, trend detection, and event timeline.

Parameters

  • species (string)
  • patient_id (string, optional)
  • patient_name (string, optional)
POST/api/v1/doolittle/report/generate

Generate clinical report from behavioral events. Returns structured JSON with alerts, recommendations, and subject summaries.

Parameters

  • events (array)
  • source_name (string)
  • session_id (string, optional)
GET/api/v1/doolittle/watchtower/reports

List all Watchtower session reports with metadata, event counts, and download links.

GET/api/v1/doolittle/health

Health check. Returns service status and available capabilities.

Need Integration Help?

The API is in alpha. Contact us for authentication credentials and rate limit details.

Request API Key