API Documentation

Use the EyeSight App API to upload images and retrieve processed model reports.

Sign in to view your personal API token.

Every request requires Authorization: Bearer YOUR_API_TOKEN.

Upload Image

POST /roi-yolo/api/v1/upload-image

Submit one or more files using multipart/form-data.

Fields

  • files[]: image or MP4 file, repeatable
  • title: optional submission title

Example

curl -X POST https://roi.bnet.dev/roi-yolo/api/v1/upload-image \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "title=Demo upload" \
  -F "files[]=@/path/to/image.jpg"

Get Report

GET /roi-yolo/api/v1/report/{submission_id}

Returns a submission report with Object statuses, per-model JSON results, and output-image URLs when available.

Example

curl https://roi.bnet.dev/roi-yolo/api/v1/report/123 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

List My Submissions

GET /roi-yolo/api/v1/submissions

Returns the token owner's submissions, newest first, with object counts, object statuses, and report URLs.

Query parameters

  • limit: optional, 1-100, defaults to 50
  • offset: optional, defaults to 0

Example

curl "https://roi.bnet.dev/roi-yolo/api/v1/submissions?limit=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Analysis implementations: Uploaded objects are processed by Analysis #1, Analysis #2, Analysis #3, and Analysis #4 queues when those workers are configured and running. Analysis #4 uses Google Vision and currently processes image uploads only.