Ingest-API-Schnellstart

Die Ingest-API verwandelt eine Rohdatei (PDF, Bild, Audio, Text) in ein durchsuchbares Dokument in Ihrer Vulgate-Bibliothek. Es ist ein zweistufiger Prozess: Datei hochladen, dann einen Verarbeitungsauftrag starten.

Die vollständige Referenz finden Sie unter /developers/ingest/overview. Diese Anleitung führt durch das Minimum, das zum Hochladen Ihrer ersten Datei per Code erforderlich ist.

Schritt 1 — Signierte Upload-URL anfordern

Vulgate verwendet signierte Storage-URLs, damit Datei-Uploads den API-Server vollständig umgehen. Fordern Sie zunächst eine URL von /api/uploads an:

curl -G "https://vulgate.ai/api/uploads" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "name=research-paper.pdf" \
  --data-urlencode "type=application/pdf"

Antwort:

{
  "url": "https://...signed-storage-url...",
  "method": "PUT",
  "headers": {
    "content-type": "application/pdf",
    "x-amz-meta-name": "research-paper.pdf"
  }
}

Behalten Sie die in den Headern zurückgegebene Datei-ID (x-amz-meta-name zusammen mit dem Pfadteil der URL) — Sie benötigen sie in Schritt 3. Die signierte URL ist für ein kurzes Zeitfenster gültig.

Schritt 2 — Datei zur signierten URL hochladen

Senden Sie den Dateiinhalt als PUT an die signierte URL mit den Headern aus Schritt 1. Fügen Sie hier nicht den Vulgate-Auth-Header hinzu — die Signatur übernimmt die Authentifizierung:

curl -X PUT "<signed-url-from-step-1>" \
  -H "Content-Type: application/pdf" \
  -H "X-Amz-Meta-Name: research-paper.pdf" \
  --data-binary @research-paper.pdf

Der Storage-Dienst antwortet bei Erfolg mit HTTP 200 und ohne Body.

Schritt 3 — Verarbeitungsauftrag starten

Weisen Sie Vulgate an, die hochgeladene Datei zu verarbeiten, indem Sie an /api/jobs mit der Datei-ID aus Schritt 1 posten:

curl -X POST "https://vulgate.ai/api/jobs" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "id": "<file-id-from-step-1>" }]
  }'

Der Auftrag läuft im Hintergrund. Sobald er abgeschlossen ist, ist das Dokument durchsuchbar — rufen Sie die Search-API oder Chat-API auf, um damit zu interagieren.

Multipart-Uploads für große Dateien

Der obige Einzeldatei-Ablauf funktioniert gut für typische Dateien. Für sehr große Dateien verwenden Sie die Multipart-Endpunkte (POST /api/uploads). Die vollständige Referenz finden Sie unter Dateien hochladen.