Verifikationsläufe API

Pipeline-Läufe starten, Status abfragen, Urteile abrufen und die Laufhistorie auflisten.

Ein Verifikationslauf führt eine Pipeline gegen eine Menge von Dateien und optionale Kontextdaten aus. Der Lauf durchläuft eine oder mehrere Phasen — KI-Analyse, Crowd-Überprüfung oder beides — und erzeugt ein abschließendes Urteil mit Konfidenzwert und Scorecard.

Endpunkt-Übersicht

Methode	Pfad	Beschreibung
`POST`	`/v2/projects/{projectId}/verification-runs`	Verifikationslauf starten
`GET`	`/v2/projects/{projectId}/verification-runs`	Läufe auflisten
`GET`	`/v2/projects/{projectId}/verification-runs/{runId}`	Lauf mit Phasendetails abrufen

Verifikationslauf starten

POST /v2/projects/{projectId}/verification-runs

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`pipeline_id`	string	Ja	Pipeline-Slug, z. B. `"verify-image-metadata"`
`file_ids`	string[]	Abhängig	IDs der einzubeziehenden Dateien; von den meisten Pipelines benötigt
`context_id`	string	Abhängig	ID eines gespeicherten Verifikationskontexts
`context`	object	Abhängig	Inline-Kontext als Schlüssel-Wert-Paare (wird nicht gespeichert)

Die Kontextanforderungen variieren je nach Pipeline. Prüfen Sie die requiredContextKeys der Pipeline, bevor Sie einen Lauf starten. Den vollständigen Katalog finden Sie unter Pipelines.

curl -X POST https://api.crowdee.ai/v2/projects/proj_abc123/verification-runs \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_id": "verify-news-article",
    "file_ids": ["file_xyz789"],
    "context": {
      "claimed_source_url": "https://example.com/article-123",
      "claimed_publication_date": "2024-10-28",
      "claimed_author": "Jane Doe"
    }
  }'

Antwort

{
  "id": "run_def456",
  "projectId": "proj_abc123",
  "pipelineId": "verify-news-article",
  "status": "running",
  "fileIds": ["file_xyz789"],
  "createdAt": "2024-11-15T10:02:00Z"
}

Speichern Sie die id — Sie werden sie abfragen, um das Urteil abzurufen.

Statuswerte eines Laufs

Status	Bedeutung
`pending`	Lauf erstellt, in der Warteschlange zur Ausführung
`running`	Phasen werden aktuell ausgeführt
`awaiting_crowd`	Wartet auf Crowd-Phasen-Antworten (nur Tier-2/3-Pipelines)
`completed`	Alle Phasen abgeschlossen; Urteil verfügbar
`failed`	Eine oder mehrere Phasen sind fehlgeschlagen; prüfen Sie das Feld `error`

Lauf abrufen

GET /v2/projects/{projectId}/verification-runs/{runId}

Gibt das vollständige Lauf-Objekt einschließlich der einzelnen Phasenergebnisse zurück, sobald der Lauf den Status completed erreicht.

curl https://api.crowdee.ai/v2/projects/proj_abc123/verification-runs/run_def456 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort — in Bearbeitung

{
  "id": "run_def456",
  "pipelineId": "verify-news-article",
  "status": "running",
  "fileIds": ["file_xyz789"],
  "stages": [
    {
      "slug": "source-credibility",
      "type": "ai",
      "order": 1,
      "status": "completed",
      "verdict": "authentic",
      "confidence": 88,
      "summary": "Source domain has strong credibility signals and consistent publication history."
    },
    {
      "slug": "content-coherence",
      "type": "ai",
      "order": 2,
      "status": "running",
      "verdict": null,
      "confidence": null,
      "summary": null
    }
  ],
  "createdAt": "2024-11-15T10:02:00Z"
}

Antwort — abgeschlossen

{
  "id": "run_def456",
  "pipelineId": "verify-news-article",
  "status": "completed",
  "verdict": "authentic",
  "confidence": 87,
  "scorecard": {
    "source_credibility": 88,
    "content_coherence": 91,
    "fact_consistency": 82,
    "crowd_validation": 85
  },
  "explanation": "The article's claims are consistent with identified primary sources. The publication date and byline match public records. Crowd reviewers confirmed factual accuracy with high confidence.",
  "report": "...",
  "fileIds": ["file_xyz789"],
  "stages": [
    {
      "slug": "source-credibility",
      "type": "ai",
      "order": 1,
      "status": "completed",
      "verdict": "authentic",
      "confidence": 88,
      "summary": "Source domain has strong credibility signals and consistent publication history."
    },
    {
      "slug": "content-coherence",
      "type": "ai",
      "order": 2,
      "status": "completed",
      "verdict": "authentic",
      "confidence": 91,
      "summary": "Internal narrative is consistent. No contradictions found between headline, body, and cited sources."
    },
    {
      "slug": "crowd-fact-check",
      "type": "crowd",
      "order": 3,
      "status": "completed",
      "verdict": "authentic",
      "confidence": 85,
      "summary": "12 crowd reviewers reached consensus: claims verified against 4 independent sources."
    }
  ],
  "createdAt": "2024-11-15T10:02:00Z",
  "completedAt": "2024-11-15T11:15:22Z"
}

Mögliche verdict-Werte: authentic, manipulated, inconclusive, unverified

Status abfragen bis zum Abschluss

Fragen Sie GET /v2/projects/{projectId}/verification-runs/{runId} ab, bis status den Wert completed oder failed hat.

Pipeline-Tier	Abfrageintervall
Tier 1 (nur KI)	Alle 5–10 Sekunden
Tier 2 (KI + Crowd)	Alle 30–60 Sekunden
Tier 3 (Kontext / mehrere Dateien)	Alle 10–60 Sekunden

Bei Tier-2-Pipelines kann der Lauf für längere Zeit im Status awaiting_crowd verbleiben, während Crowd-Worker ihre Überprüfungsaufgaben abschließen. Implementieren Sie idempotentes Polling und erwägen Sie, es als Hintergrund-Job auszuführen, anstatt eine synchrone Anfrage zu blockieren. Crowd-Phasen werden in der Regel innerhalb von 1–4 Stunden abgeschlossen, abhängig von der Aufgabenkomplexität und den verfügbaren Workern.

# Keep polling until status is completed or failed
while true; do
  RESPONSE=$(curl -s https://api.crowdee.ai/v2/projects/proj_abc123/verification-runs/run_def456 \
    -H "X-API-Key: crw_YOUR_API_KEY")
  STATUS=$(echo $RESPONSE | jq -r '.status')
  echo "Status: $STATUS"
  if [[ "$STATUS" == "completed" || "$STATUS" == "failed" ]]; then
    echo $RESPONSE | jq .
    break
  fi
  sleep 10
done

Läufe auflisten

GET /v2/projects/{projectId}/verification-runs

Abfrageparameter

Parameter	Typ	Beschreibung
`status`	string	Nach Laufstatus filtern
`pipeline_id`	string	Nach Pipeline-Slug filtern
`limit`	integer	Standard 20, maximal 200
`offset`	integer	Standard 0

# List completed runs for a specific pipeline
curl "https://api.crowdee.ai/v2/projects/proj_abc123/verification-runs?status=completed&pipeline_id=verify-image-metadata&limit=20" \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "data": [
    {
      "id": "run_def456",
      "pipelineId": "verify-image-metadata",
      "status": "completed",
      "verdict": "authentic",
      "confidence": 92,
      "createdAt": "2024-11-15T10:02:00Z",
      "completedAt": "2024-11-15T10:02:18Z"
    },
    {
      "id": "run_ghi789",
      "pipelineId": "verify-image-metadata",
      "status": "completed",
      "verdict": "manipulated",
      "confidence": 96,
      "createdAt": "2024-11-14T08:45:00Z",
      "completedAt": "2024-11-14T08:45:31Z"
    }
  ],
  "total": 8,
  "limit": 20,
  "offset": 0
}

Verifikationsläufe API

On this page