Verifizierungskontexte

Pipelines liefern bessere Urteile, wenn sie wissen, was Sie erwarten als wahr anzunehmen. Ein Foto lässt sich leichter authentifizieren, wenn die Pipeline die angegebene Kamera, den Ort und das Datum kennt. Ein Nachrichtenartikel lässt sich leichter auf Fakten prüfen, wenn die Pipeline die angegebene Quell-URL kennt.

Verifizierungskontexte ermöglichen es Ihnen, diese angegebenen Metadaten — sogenannte Kontextschlüssel — als benannte, wiederverwendbare Mengen bereitzustellen, die einem Projekt zugeordnet sind. Sie referenzieren einen Kontext beim Erstellen eines Verifizierungsdurchlaufs, anstatt dieselben Felder in jede Anfrage einzubetten.

Was ist ein Kontext?

Ein Verifizierungskontext ist eine benannte Menge von Schlüssel-Wert-Paaren, die auf Projektebene gespeichert wird. Kontexte sind wiederverwendbar: Sie können denselben Kontext für viele Durchläufe verwenden, ohne sich zu wiederholen, und Sie können eine Bibliothek von Kontexten aufbauen, die wiederkehrenden Quellen oder Szenarien entsprechen.

Beispiel: Ein Kontext mit dem Namen "Reuters Wire Nov 2024" könnte Folgendes enthalten:

{
  "name": "Reuters Wire Nov 2024",
  "data": {
    "claimed_source": "Reuters",
    "claimed_date": "2024-11-15",
    "claimed_location": "Paris, France"
  }
}

Jeder Durchlauf, der auf diesen Kontext verweist, hat diese Angaben für jede Stufe verfügbar, die sie verwenden kann.

Kontextschlüssel nach Pipeline

Die folgende Tabelle listet die am häufigsten verwendeten Kontextschlüssel und die Pipelines auf, die sie verarbeiten.

Optionale Schlüssel bereichern die Analyse, wenn sie angegeben werden — die Pipeline verwendet sie, sofern vorhanden, und fährt ohne sie fort, wenn nicht. Erforderliche Schlüssel führen dazu, dass die Pipeline einen 422-Fehler zurückgibt, wenn sie fehlen und keine Datei ein gleichwertiges Signal liefert.

Einen Kontext erstellen

Erstellen Sie einen Kontext, indem Sie eine Anfrage an den Verifizierungskontexte-Endpunkt des Projekts senden.

curl -X POST \
  https://api.crowdee.ai/v2/projects/{projectId}/verification-contexts \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Reuters Wire Nov 2024",
    "data": {
      "claimed_source": "Reuters",
      "claimed_date": "2024-11-15",
      "claimed_location": "Paris, France"
    }
  }'

Beispielantwort:

{
  "id": "ctx_abc123",
  "name": "Reuters Wire Nov 2024",
  "data": {
    "claimed_source": "Reuters",
    "claimed_date": "2024-11-15",
    "claimed_location": "Paris, France"
  },
  "projectId": "proj_abc123",
  "createdAt": "2024-11-15T09:00:00Z"
}

Speichern Sie die id — Sie verwenden sie als context_id beim Erstellen von Durchläufen.

Einen Kontext in einem Durchlauf verwenden

Sie können einem Verifizierungsdurchlauf auf zwei Arten einen Kontext zuordnen: durch Referenzierung eines gespeicherten Kontexts anhand seiner ID oder durch direktes Übergeben eines Inline-Kontextobjekts in der Durchlaufanfrage.

curl -X POST \
  https://api.crowdee.ai/v2/projects/{projectId}/verification-runs \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_id": "verify-image-deep",
    "file_ids": ["file_xyz789"],
    "context_id": "ctx_abc123"
  }'

curl -X POST \
  https://api.crowdee.ai/v2/projects/{projectId}/verification-runs \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_id": "verify-image-deep",
    "file_ids": ["file_xyz789"],
    "context": {
      "claimed_source": "AP Photo",
      "claimed_date": "2024-11-14",
      "claimed_location": "Berlin, Germany"
    }
  }'

Kontexte auflisten

Alle Kontexte eines Projekts abrufen:

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

Um alle Kontexte Ihrer gesamten Organisation aufzulisten:

curl https://api.crowdee.ai/v2/verification-contexts \
  -H "X-API-Key: crw_YOUR_API_KEY"

Aktualisieren und Löschen

Einen Kontext mit PUT aktualisieren:

curl -X PUT \
  https://api.crowdee.ai/v2/projects/{projectId}/verification-contexts/{contextId} \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Reuters Wire Nov 2024 (revised)",
    "data": {
      "claimed_source": "Reuters",
      "claimed_date": "2024-11-15",
      "claimed_location": "Paris, France",
      "claimed_photographer": "John Doe"
    }
  }'

Einen Kontext mit DELETE löschen:

curl -X DELETE \
  https://api.crowdee.ai/v2/projects/{projectId}/verification-contexts/{contextId} \
  -H "X-API-Key: crw_YOUR_API_KEY"