API für visuelle Inspektion - Steer Autos Documentation

POST /v1/inspections/visual

Übermitteln Sie Fahrzeugbilder für eine umfassende visuelle Inspektion mit fortschrittlicher Computer-Vision-KI. Erkennt Kratzer, Dellen, Lackschäden, Glasschäden und mehr mit 94% Genauigkeit.

Anfrage

curl -X POST "https://api.steerai.autos/v1/inspections/visual" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "images": [
      {
        "url": "https://storage.example.com/front.jpg",
        "angle": "front",
        "type": "exterior"
      },
      {
        "url": "https://storage.example.com/rear.jpg",
        "angle": "rear",
        "type": "exterior"
      },
      {
        "url": "https://storage.example.com/left-side.jpg",
        "angle": "left_side",
        "type": "exterior"
      },
      {
        "url": "https://storage.example.com/right-side.jpg",
        "angle": "right_side",
        "type": "exterior"
      }
    ],
    "options": {
      "detailed_analysis": true,
      "generate_report": true,
      "detect_hidden_damage": false
    }
  }'

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`vehicle_id`	string	Ja	Fahrzeugkennung
`images`	array	Ja	Array von Bildobjekten (min. 4, max. 50)
`images[].url`	string	Ja	Öffentliche URL zum Bild
`images[].angle`	string	Ja	`front`, `rear`, `left_side`, `right_side`, `front_left`, `front_right`, `rear_left`, `rear_right`, `top`, `interior`, `dashboard`, `engine`, `trunk`, `undercarriage`
`images[].type`	string	Ja	`exterior`, `interior`, `mechanical`
`options.detailed_analysis`	boolean	Nein	Detaillierte Schadensmessungen einschließen (Standard: false)
`options.generate_report`	boolean	Nein	PDF-Bericht generieren (Standard: true)
`options.detect_hidden_damage`	boolean	Nein	Erweiterte Analyse für verdeckte Schäden (Standard: false)

Antwort

{
  "status": "success",
  "data": {
    "inspection_id": "vis_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "status": "completed",
    "created_at": "2024-01-15T10:30:00Z",
    "completed_at": "2024-01-15T10:30:45Z",
    "processing_time": 45.2,
    "results": {
      "overall_condition": "fair",
      "condition_score": 7.2,
      "confidence": 0.94,
      "damages": [
        {
          "damage_id": "dmg_front_bumper_001",
          "type": "scratch",
          "severity": "minor",
          "location": {
            "part": "front_bumper",
            "side": "front",
            "coordinates": {
              "x": 245,
              "y": 180,
              "width": 85,
              "height": 12
            }
          },
          "measurements": {
            "length": 8.5,
            "width": 1.2,
            "depth": 0.3,
            "unit": "cm"
          },
          "confidence": 0.96,
          "image_url": "https://storage.example.com/front.jpg",
          "annotated_url": "https://results.steerai.autos/dmg_front_bumper_001_annotated.jpg",
          "estimated_repair": {
            "min": 150,
            "max": 300,
            "currency": "USD",
            "repair_type": "paint_touch_up"
          }
        },
        {
          "damage_id": "dmg_rear_door_left_002",
          "type": "dent",
          "severity": "moderate",
          "location": {
            "part": "rear_door_left",
            "side": "left",
            "coordinates": {
              "x": 320,
              "y": 240,
              "width": 120,
              "height": 95
            }
          },
          "measurements": {
            "diameter": 11.5,
            "depth": 2.8,
            "unit": "cm"
          },
          "confidence": 0.89,
          "image_url": "https://storage.example.com/left-side.jpg",
          "annotated_url": "https://results.steerai.autos/dmg_rear_door_left_002_annotated.jpg",
          "estimated_repair": {
            "min": 500,
            "max": 850,
            "currency": "USD",
            "repair_type": "pdr_and_paint"
          }
        }
      ],
      "damage_summary": {
        "total_damages": 2,
        "by_severity": {
          "minor": 1,
          "moderate": 1,
          "severe": 0,
          "critical": 0
        },
        "by_type": {
          "scratch": 1,
          "dent": 1,
          "rust": 0,
          "crack": 0,
          "paint_damage": 0
        },
        "total_estimated_repair": {
          "min": 650,
          "max": 1150,
          "currency": "USD"
        }
      },
      "parts_affected": [
        {
          "part": "front_bumper",
          "condition": "good",
          "damage_count": 1
        },
        {
          "part": "rear_door_left",
          "condition": "fair",
          "damage_count": 1
        }
      ]
    },
    "reports": {
      "pdf_url": "https://reports.steerai.autos/vis_1234567890abcdef.pdf",
      "json_url": "https://api.steerai.autos/v1/inspections/visual/vis_1234567890abcdef/report"
    }
  },
  "meta": {
    "request_id": "req_visual_abc123",
    "processing_time": 45.234,
    "images_processed": 4,
    "ai_model_version": "v3.2.1"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`inspection_id`	string	Eindeutige Kennung der visuellen Inspektion
`status`	string	`processing`, `completed`, `failed`
`results.overall_condition`	string	`excellent`, `good`, `fair`, `poor`, `critical`
`results.condition_score`	float	Score von 0–10 (10 = perfekter Zustand)
`results.confidence`	float	KI-Vertrauensscore (0–1)
`damages[].type`	string	`scratch`, `dent`, `rust`, `crack`, `paint_damage`, `glass_damage`, `panel_damage`
`damages[].severity`	string	`minor`, `moderate`, `severe`, `critical`
`damages[].measurements`	object	Physische Abmessungen des Schadens
`damages[].annotated_url`	string	Bild mit markiertem Schaden

Schadenstypen

Lack- und Oberflächenschäden

• Kratzer: Oberflächlicher Lackschaden • Lackschaden: Abgeplatzter, abblätternder oder ausgeblichener Lack • Rost: Korrosion auf Metalloberflächen • Oxidation: Oberflächenoxidation und Verwitterung

Strukturelle Schäden

• Delle: Aufprallschaden mit Delle • Karosserieschaden: Verbogene oder falsch ausgerichtete Karosserieteile • Riss: Risse in Karosserieteilen • Rahmenschaden: Strukturelle Rahmenschäden

Glas & Zierleisten

• Glasschaden: Risse oder Absplitterungen in Scheiben • Scheinwerferschaden: Trübe, rissige oder beschädigte Scheinwerfer • Zierleistenschaden: Fehlende oder beschädigte Zierleisten • Spiegelschaden: Beschädigte oder gebrochene Spiegel

Fehlerantworten

400 Bad Request

{
  "status": "error",
  "error": {
    "code": "INSUFFICIENT_IMAGES",
    "message": "Minimum 4 images required for visual inspection",
    "type": "validation_error",
    "field": "images"
  }
}

422 Unprocessable Entity

{
  "status": "error",
  "error": {
    "code": "IMAGE_QUALITY_TOO_LOW",
    "message": "Image quality insufficient for analysis. Please provide higher resolution images (min 1280x720)",
    "type": "validation_error",
    "field": "images[2].url",
    "details": {
      "image_index": 2,
      "current_resolution": "640x480",
      "minimum_resolution": "1280x720"
    }
  }
}

Bildanforderungen

Standards für Bildqualität

Minimale Auflösung: 1280x720 Pixel
Empfohlene Auflösung: 1920x1080 Pixel oder höher
Dateiformat: JPG, PNG, HEIC
Maximale Dateigröße: 10MB pro Bild
Beleuchtung: Gutes natürliches oder künstliches Licht
Fokus: Scharfe, klare Bilder ohne Bewegungsunschärfe

Bewährte Praktiken

Bildaufnahme

Optimale Foto-Richtlinien• Erforderliche Blickwinkel vollständig erfassen • Gute Beleuchtung nutzen (Schatten vermeiden) • Kamera 2–3 Meter vom Fahrzeug entfernt halten • Sicherstellen, dass das gesamte Panel im Bild ist • Reflexionen und Blendung vermeiden

Schadenserkennung

Genauigkeit maximieren• Fahrzeug vor dem Fotografieren reinigen • Nahaufnahmen von Schäden machen • Mehrere Blickwinkel je Schaden aufnehmen • Referenzobjekte für Maßstab beilegen • Konsistente Beleuchtung über alle Bilder

Webhooks

Konfigurieren Sie Webhooks, um Echtzeit-Updates nach Abschluss der Inspektion zu erhalten:

{
  "event": "visual_inspection.completed",
  "timestamp": "2024-01-15T10:30:45Z",
  "data": {
    "inspection_id": "vis_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "status": "completed",
    "damages_detected": 2,
    "overall_condition": "fair",
    "condition_score": 7.2,
    "report_url": "https://reports.steerai.autos/vis_1234567890abcdef.pdf"
  }
}

Beispiel: Ergebnisse der visuellen Inspektion abrufen

curl -X GET "https://api.steerai.autos/v1/inspections/visual/vis_1234567890abcdef" \
  -H "Authorization: Bearer YOUR_API_KEY"

Beispiel: Fahrzeuginspektionen auflisten

curl -X GET "https://api.steerai.autos/v1/inspections/visual?vehicle_id=veh_1234567890abcdef&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Abfrageparameter:

vehicle_id (string): Nach Fahrzeug filtern
status (string): Nach Status filtern (processing, completed, failed)
created_after (string): ISO-8601-Datumsfilter
created_before (string): ISO-8601-Datumsfilter
limit (integer): Ergebnisse pro Seite (Standard: 20, max: 100)
offset (integer): Paginierungs-Offset

Performance-Tipp: Für schnellere Verarbeitung Bilder vor dem Upload auf die empfohlene Auflösung (1920x1080) skalieren. Größere Bilder erhöhen die Genauigkeit nicht und verlängern die Verarbeitung.

API-Dokumentation

​POST /v1/inspections/visual

​Anfrage

​Anfrage-Body

​Antwort

​Antwortfelder

​Schadenstypen

​Fehlerantworten

​400 Bad Request

​422 Unprocessable Entity

​Bildanforderungen

​Bewährte Praktiken

Bildaufnahme

Schadenserkennung

​Webhooks

​Beispiel: Ergebnisse der visuellen Inspektion abrufen

​Beispiel: Fahrzeuginspektionen auflisten

POST /v1/inspections/visual

Anfrage

Anfrage-Body

Antwort

Antwortfelder

Schadenstypen

Fehlerantworten

400 Bad Request

422 Unprocessable Entity

Bildanforderungen

Bewährte Praktiken

Webhooks

Beispiel: Ergebnisse der visuellen Inspektion abrufen

Beispiel: Fahrzeuginspektionen auflisten