Spaces:
Sleeping
Sleeping
| title: Amazon Trailer Inspector | |
| emoji: 🚛 | |
| colorFrom: blue | |
| colorTo: indigo | |
| sdk: docker | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| # 🚛 Amazon Trailer Inspector — REST API | |
| AI-powered trailer inspection pipeline exposed as a **REST API**. | |
| Submit up to **6 labeled images** and receive a structured JSON inspection report. | |
| --- | |
| ## Endpoint | |
| ### `POST /inspect` | |
| Submit all images in one request. All aspects are analyzed **in parallel**. | |
| #### Request Body (JSON) | |
| ```json | |
| { | |
| "images": [ | |
| { "label": "front_left", "image_base64": "<base64-string>" }, | |
| { "label": "front_right", "image_base64": "<base64-string>" }, | |
| { "label": "rear_left", "image_base64": "<base64-string>" }, | |
| { "label": "rear_right", "image_base64": "<base64-string>" }, | |
| { "label": "inside", "image_base64": "<base64-string>" }, | |
| { "label": "door", "image_base64": "<base64-string>" } | |
| ] | |
| } | |
| ``` | |
| **Accepted labels:** `front_left`, `front_right`, `rear_left`, `rear_right`, `inside`, `door` | |
| - Images can be raw base64 OR a data-URI (`data:image/jpeg;base64,...`) | |
| - All 6 images are optional — only send the ones you have | |
| - Each label can appear at most once per request | |
| - `rear_left` and `rear_right` must **both** be present for full rear confirmation | |
| --- | |
| #### Response Body (JSON) | |
| ```json | |
| { | |
| "status": "success", | |
| "images_received": ["front_left", "front_right", "rear_left", "rear_right", "inside", "door"], | |
| "labels_missing": [], | |
| "report": { | |
| "front": { | |
| "label": "Front Left / Right", | |
| "images_provided": ["front_left", "front_right"], | |
| "components": { | |
| "Sensors": "detected", | |
| "GPS Device": "missing", | |
| "Prime Logo": "detected", | |
| "Trailer ID Label": "detected" | |
| }, | |
| "notes": [] | |
| }, | |
| "rear": { | |
| "label": "Rear Left / Right", | |
| "images_provided": ["rear_left", "rear_right"], | |
| "components": { | |
| "Side Skirts / Fins": { "status": "detected", "count": "2/2" }, | |
| "Edge Kit": { "status": "partially detected (left side only)", "count": "1/2" } | |
| }, | |
| "notes": [] | |
| }, | |
| "inside": { | |
| "label": "Inside Trailer", | |
| "images_provided": ["inside"], | |
| "components": { | |
| "Side Guards": "detected", | |
| "Flooring": "detected" | |
| }, | |
| "notes": [] | |
| }, | |
| "door": { | |
| "label": "Door Details", | |
| "images_provided": ["door"], | |
| "components": { | |
| "Latch Kit & Lash Links": "detected", | |
| "Grote LED Lights": "missing" | |
| }, | |
| "notes": [] | |
| } | |
| } | |
| } | |
| ``` | |
| --- | |
| ## Component Values | |
| | Aspect | Component Values | | |
| |--------|-----------------| | |
| | Front | `"detected"` or `"missing"` (OR logic — detected if found in either left or right image) | | |
| | Rear | `"detected"`, `"partially detected (left side only)"`, `"partially detected (right side only)"`, or `"missing"` — plus `count` (`"2/2"`, `"1/2"`, `"0/2"`) | | |
| | Inside | `"detected"` or `"missing"` | | |
| | Door | `"detected"` or `"missing"` | | |
| --- | |
| ## Notes Field | |
| The `notes` array in each aspect section contains warnings such as: | |
| - `"front_left: image missing from input"` — label was not submitted | |
| - `"rear_right: invalid image (wrong angle/side)"` — model rejected the image | |
| - `"door: invalid image (not a valid rear door view)"` — wrong image type | |
| --- | |
| ## Other Endpoints | |
| | Method | Path | Description | | |
| |--------|------------|--------------------------| | |
| | GET | `/` | Service info | | |
| | GET | `/health` | HF_TOKEN status + models | | |
| | GET | `/docs` | Interactive Swagger UI | | |
| --- | |
| ## Setup | |
| Space Settings → **Repository Secrets** → add `GEMINI_API_KEY` | |
| Get a **free** Gemini API key at [aistudio.google.com/apikey](https://aistudio.google.com/apikey) | |
| No credit card required — free tier includes **1,500 requests/day**. | |
| --- | |
| ## Models (Google Gemini, free tier) | |
| 1. `gemini-2.0-flash` — primary (best quality + speed, free) | |
| 2. `gemini-2.0-flash-lite` — fallback 1 (lighter 2.0 variant, free tier) | |
| 3. `gemini-1.5-flash-latest` — fallback 2 (1.5 gen, stable free tier) |