Dateien & Anreicherung

Dateien sind die primäre Eingabe für jede Verifizierungspipeline. Bevor eine Pipeline eine Datei analysieren kann, führt Crowdee einen Anreicherungsschritt durch, der strukturierte technische Metadaten extrahiert — Codec-Informationen, EXIF-Daten, Lautstärkepegel, Seitenzahlen und mehr. Bei den meisten Pipelines muss die Anreicherung abgeschlossen sein, bevor sie eine Ausführungsanfrage akzeptieren.

Diese Seite erläutert den vollständigen Lebenszyklus: Upload, Anreicherung und Zugriff auf die angereicherten Dateidaten.

Unterstützte Medientypen

Dateien hochladen

Laden Sie Dateien über eine multipart/form-data POST-Anfrage an den Projektdateien-Endpunkt hoch. Die project_id ist Teil des URL-Pfads — Dateien gehören immer zu einem bestimmten Projekt.

curl -X POST https://api.crowdee.ai/v2/projects/{projectId}/files \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -F "file=@photo.jpg"

Beispielantwort:

{
  "id": "file_xyz789",
  "name": "photo.jpg",
  "mimeType": "image/jpeg",
  "size": 2048576,
  "enrichmentStatus": "pending",
  "privacyLevel": "private",
  "createdAt": "2024-11-15T10:01:00Z"
}

Speichern Sie die id — Sie verwenden sie als {fileId} in allen nachfolgenden Anfragen.

Anreicherungsprozess

Die Anreicherung startet unmittelbar nach dem Upload automatisch. Der Anreicherungs-Worker verarbeitet die Datei im Hintergrund und befüllt das Feld metadata mit strukturierten technischen Daten.

Dateistatus abfragen:

curl https://api.crowdee.ai/v2/projects/{projectId}/files/{fileId} \
  -H "X-API-Key: crw_YOUR_API_KEY"

Anreicherungsfelder nach Medientyp

Nach Abschluss der Anreicherung enthält das Objekt file.metadata je nach Dateityp die folgenden Felder.

{
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "exif": {
    "gps": {
      "latitude": 48.8566,
      "longitude": 2.3522
    },
    "cameraModel": "iPhone 15 Pro",
    "creationDate": "2024-11-14T16:42:00Z",
    "software": "17.1.1"
  }
}

{
  "duration": 183.4,
  "codec": "mp3",
  "sampleRate": 44100,
  "channels": 2,
  "bitrate": 320000,
  "loudness": {
    "integrated": -14.2,
    "range": 7.1,
    "peak": -0.3
  }
}

{
  "duration": 94.7,
  "codec": "h264",
  "resolution": {
    "width": 1920,
    "height": 1080
  },
  "fps": 29.97,
  "bitrate": 8500000,
  "extractedFrameFileIds": [
    "file_frame_01",
    "file_frame_02",
    "file_frame_03"
  ]
}

{
  "wordCount": 1842,
  "charCount": 10973,
  "pageCount": 6,
  "author": "Jane Smith",
  "creationDate": "2024-10-20T09:15:00Z"
}

Presigned-URL-Dateizugriff

Um die Originaldatei herunterzuladen, rufen Sie den Download-Endpunkt auf. Die API antwortet mit einer 302-Weiterleitung zu einer temporären Presigned-URL, die auf S3-kompatiblem Speicher gehostet wird.

# -L folgt der Weiterleitung automatisch
curl -L https://api.crowdee.ai/v2/files/{fileId}/download \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -o downloaded-file.jpg

Datei-Datenschutzstufen

Dateien sind standardmäßig privat. Das Feld privacyLevel steuert, wer auf eine Datei zugreifen kann:

Fehlgeschlagene Anreicherung wiederholen

Wenn die Anreicherung aufgrund eines vorübergehenden Fehlers fehlschlägt (Dienst nicht verfügbar, temporäres Speicherproblem), wiederholen Sie sie ohne erneuten Upload:

curl -X POST \
  https://api.crowdee.ai/v2/projects/{projectId}/files/{fileId}/enrichment/retry \
  -H "X-API-Key: crw_YOUR_API_KEY"

Die Datei durchläuft erneut den Zyklus pending → running → completed. Wenn die Anreicherung wiederholt fehlschlägt, prüfen Sie, ob das Dateiformat unterstützt wird und ob die Datei nicht beschädigt ist.