Asynchrone KI-Webhooks auf localhost: OpenAI Batch & Gemini – zwei Webhook-Modelle
Fehlerbehebung bei OpenAI Batch- und Gemini-Webhooks auf localhost, ohne Jobs erneut ausführen zu müssen. Erfahren Sie mehr über Gemini's statische und dynamische Webhook-Modelle, HMAC, JWKS und Batch-Payloads.

Quick answer
Asynchrone KI-Webhooks auf localhost: OpenAI Batch & Gemini (2026): webhook testing answer
For local webhook testing, run your app locally, expose it with a public HTTPS tunnel, and paste the stable callback URL into the provider dashboard.
How do I test webhooks on localhost?
Start your local server, open a public HTTPS tunnel to that port, configure the provider webhook URL, and inspect events in your local logs.
Why does a stable webhook URL matter?
Stable URLs prevent provider dashboards from needing manual callback updates every time you restart a tunnel.
Batch-Jobs sind teuer beim Debuggen. Sie reichen Tausende von Prompts ein, warten Stunden, und Ihr Callback-Handler sieht erst reale Eingaben, wenn der Job beendet ist. Wenn der Handler einen Fehler hat, ist die bequeme Lösung, den Batch erneut laufen zu lassen.
Sie sollten es nicht müssen. OpenAI und Google pushen jetzt Completion-Ereignisse statt Sie polling zu lassen. Google kündigte am 4. Mai 2026 Webhooks für Gemini API an. OpenAI liefert Callback, die dem Standard Webhooks-Spezifikation für Batches, Hintergrundantworten, Feineinstellungsjobs und andere Ereignisse folgen. Dieser Leitfaden handelt vom Job-Lifecycle. Er erklärt, wie man diese Callback auf localhost erhält, wie Gemini’s zwei Konfigurationsmodelle sich unterscheiden und warum ein Batch-Erfolg-Ereignis Ihnen einen Verweis statt Ergebnisse gibt. Außerdem zeigt er, wie Sie an Ihrem Handler iterieren können, ohne erneut einen Batch zu bezahlen.
(Signaturfehler hinter einem Tunnel, z. B. neu serialisierte Bodies, ist ein separates Thema und wird hier nicht im Detail behandelt.)
Warum lang laufende KI-Jobs Webhooks brauchen
Polling funktioniert, erzeugt aber unnötige Aufrufe und erhöht die Latenz. Bei OpenAI pollt man GET /v1/batches/{batch_id}. Bei Gemini beschreibt Googles Launch-Post repetitives Aufrufen von GET-Operationen. Google rahmt das Problem als agentische und volumenstarke Arbeit ein, wie Deep Research, lange Videogenerierung oder Tausende Prompts durch die Batch-API, bei der Operationen Minuten oder Stunden dauern können.
Das Abschlussfenster ist die zentrale Kennzahl. Die Batch‑API von OpenAI akzeptiert derzeit nur ein Abschlussfenster von 24h, und die Dokumentation verspricht, dass jeder Batch innerhalb von 24 Stunden abgeschlossen wird, oft früher. Garmins Event‑Katalog beschreibt batch.expired als Batch, der innerhalb eines 24‑Stunden‑Zeitfensters nicht abgeschlossen wurde. Ein Callback kann daher zu jedem Zeitpunkt innerhalb dieses Tages eintreffen. Das ist der Moment, in dem Ihr Laptop höchstwahrscheinlich das Netzwerk gewechselt, neu gestartet oder in Schlaf gegangen ist.
Drei Details sofort beachten:
- Gemini’s Webhooks-Dokumentation bezeichnet das Feature als Vorschau, auch wenn Googles Launch-Post angibt, dass es allen Gemini API-Entwicklern zur Verfügung steht. Erwarten Sie Änderungen der Details und prüfen Sie die Docs erneut, bevor Sie es ausliefern.
- OpenAI’s Batch API bietet einen Kostenrabatt von 50% gegenüber synchronen APIs. Dieser Rabatt ist auch der Grund, warum das erneute Ausführen eines fehlgeschlagenen Batches wegen eines Handler-Bugs so verlockend und verschwenderisch ist.
OpenAI- und Gemini-Webhooks auf einen Blick
| OpenAI | Gemini API | |
|---|---|---|
| Wo konfiguriert | Pro Projekt: Dashboard (Name, öffentliche URL, Ereignistypen) oder die Webhooks API | Statisch: WebhookService API. Dynamisch: webhook_config bei einer Anfrage |
| Batch-Ereignisse | batch.completed, batch.failed, batch.cancelled, batch.expired |
batch.succeeded, batch.failed, batch.cancelled, batch.expired |
| Andere asynchrone Ereignisse | response.completed/failed/cancelled/incomplete, fine_tuning.job.succeeded/failed/cancelled, eval.run.succeeded/failed/canceled, realtime.call.incoming |
interaction.requires_action/completed/failed/cancelled, video.generated |
| Signing | Standard Webhooks-Headers (webhook-id, webhook-timestamp, webhook-signature); Secret bei der Erstellung des Endpunkts gezeigt |
Statisch: Standard Webhooks HMAC, Secret bei Erstellung gezeigt. Dynamisch: RS256 JWT im Webhook-Signature-Header, validiert gegen JWKS |
| Payload-Stil | Dünn: object, Ereignis-ID, type, created_at, data.id |
Dünn: type, version, timestamp, data |
| Retry-Strategie | Nicht-2xx oder keine Antwort innerhalb weniger Sekunden werden bis zu 72 Stunden mit exponentiellem Backoff erneut versucht; 3xx Redirects werden nicht gefolgt | Wiederholt sich 24 Stunden mit exponentiellem Backoff; innerhalb weniger Sekunden 2xx antworten |
| Reifegrad | Dokumentierte Anleitung und API-Referenz | Als Vorschau in der Docs gekennzeichnet |
Drei Details sind sofort wichtig.
- Der Erfolg-Ereignisname ist unterschiedlich. Es ist
batch.completedbei OpenAI undbatch.succeededbei Gemini. Ein gemeinsamer Handler, der anhand destype-Strings abfragt, benötigt eine explizite Zuordnung. - Beide Anbieter liefern mindestens einmal, sodass Duplikate auftreten können. Verwenden Sie den
webhook-id-Header als Idempotenz-Schlüssel. Die OpenAI-Dokumentation empfiehlt dies ausdrücklich. Geminis Payload-Beispiel hat kein Event-ID im Body, daher ist der Header dort die einzige verlässliche Wahl. - Ein „completed“ OpenAI Batch verspricht nicht, dass jede Anfrage erfolgreich war. Das Batch-Objekt verfolgt
request_counts(gesamt, abgeschlossen, fehlgeschlagen) und trenntoutput_file_idvonerror_file_id. Ein abgeschlossener Batch kann weiterhin fehlgeschlagene Zeilen enthalten.
Geminis zwei Webhook-Modelle: static vs dynamic
Dieser Teil unterscheidet sich wirklich von OpenAI, und der Grund, warum Gemini-Handler schlechter zu testen sind.
Statische Webhooks: Einmal registrieren, alles empfangen
Statische Webhooks sind projektweite Endpunkte, erstellt über die WebhookService API. Sie lösen jedes passende Ereignis im Projekt aus. Neben dem Erstellen können Sie sie abrufen, auflisten, aktualisieren und löschen und ihr Signing-Secret rotieren.
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
webhook = client.webhooks.create(
name="MyBatchWebhook",
subscribed_events=["batch.succeeded", "batch.failed"],
uri="https://my-api.com/gemini-callback",
)
# The signing secret is returned only once. Store it securely.
webhook_secret = webhook.new_signing_secret
Statische Webhooks sind signiert mit HMAC unter dem Standard Webhooks-Schema. Das Signing-Secret wird nur bei der Erstellung angezeigt, und wenn Sie es verlieren, rotieren Sie es statt es abzurufen. Rotation erlaubt Ihnen zu wählen, ob vorherige Secrets sofort widerrufen werden oder nach einer 24‑Stunden‑Gnadenfrist (revocation_behavior="revoke_previous_secrets_after_h24" im Python-SDK). Die Gnadenfrist lässt das alte Secret weiter funktionieren, während Sie das neue ausrollen.
Local-Development-Hinweis: Ein statischer Webhook deckt das gesamte Projekt ab. Ein Entwickler-Endpunkt, der im selben Google Cloud‑Projekt wie die Produktion registriert ist, erhält Produktions-Ereignisse und Produktion erhält Ihre. Verwenden Sie ein separates Projekt und API-Schlüssel für die Entwicklung. OpenAI hat dieselbe Struktur: Die Webhook-Endpunkte werden projektweise konfiguriert, also nutzen Sie dort auch ein separates Projekt für die Entwicklung.
Dynamische Webhooks: pro‑Job Overrides
Dynamische Webhooks sind anforderungsbasierte Overrides. Sie übergeben webhook_config im Aufruf, der den Job erstellt. Googles Launch-Post zeigt dies für einen Batch:
from google import genai
client = genai.Client()
file_batch_job = client.batches.create(
model="<your-model>",
src=inline_requests,
config={
"display_name": "My Setup",
"webhook_config": {
"uris": ["https://my-api.com/gemini-webhook-dynamic"],
"user_metadata": {"job_group": "nightly-eval", "priority": "high"},
},
},
)
Vier Details sind zu beachten:
urisist eine Liste, unduser_metadataist ein beliebiges Schlüssel-Wert-Objekt, das Sie dem Job anhängen. Das dokumentierte Thin-Payload-Beispiel zeigt nicht, dassuser_metadatain der Lieferung zurückkommt. Bevor Sie darauf routen, prüfen Sie eine aufgezeichnete reale Lieferung, um zu sehen, ob es erscheint und wo.- Für die Interactions API ist
background=Trueerforderlich, wann immerwebhook_configgesetzt ist. Googles Interactions-Beispiele enthalten außerdem einen Kommentar, dass sie nur mit SDK-Versionen funktionieren, die neuer als 2.0.0 sind. - Dynamische Webhooks verwenden asymmetrische Signaturen. Ihr Listener liest ein JWT aus dem
Webhook-Signature-Header und überprüft es anhand von Googles öffentlichen Schlüsseln (RS256). - Googles Docs sind inkonsistent darüber, wo diese Schlüssel leben. Der Fließtext verlinkt auf
https://www.googleapis.com/oauth2/v3/certs, während der Beispielcodehttps://generativelanguage.googleapis.com/.well-known/jwks.jsonabruf. Die Beispiele übergeben außerdem einen Platzhalterwert füraudiencemit einem Hinweis, der etwas wie Ihre Projekt-Client-ID nahelegt. Bestätigen Sie die genaue Schlüssel-URL und das Audience‑Feld anhand der aktuellen Docs, bevor Sie eine der Optionen durchsetzen.
Ein Handler, der beide Modelle unterstützt, benötigt daher zwei Verifizierungswege, da eine Standard Webhooks‑Bibliothek das dynamische JWT nicht verifiziert. Googles Beispiele holen den Schlüsselsatz bei jeder Anforderung. In der Produktion sollten Sie ihn cachen und bei einem unbekannten kid erneut abrufen.
Welche sollten Sie verwenden?
Verwenden Sie statisch für Dinge, die immer passieren sollen: Audit-Logging, eine Slack-Benachrichtigung, ein Data-Sync-Job. Verwenden Sie dynamisch, wenn Sie bestimmte Jobs zu bestimmten Orten routen möchten, z. B. eine Worker-Warteschlange pro Mandant oder den Batch eines Entwicklers auf dessen Maschine, ohne die geteilte Projekt-Konfiguration zu beeinflussen. Für das lokale Debugging ist dynamisch oft die sicherere Wahl. Der Callback-Zielort befindet sich im Job, nicht im Projektstatus, den Ihre Teamkollegen teilen.
Der Batch-Erfolg-Payload ist nur ein Verweis, nicht das Ergebnis
Keiner der Anbieter sendet Ihnen die Ausgaben. Googles Envelope ist ausdrücklich ein Modell mit einem „dünnen Payload“:
{
"type": "batch.succeeded",
"version": "v1",
"timestamp": "2026-01-22T12:00:00Z",
"data": {
"id": "batch_123456",
"output_file_uri": "gs://my-bucket/results.jsonl"
}
}
Googles Beispiel verwendet eine gs://-URI, die kein HTTPS-Link ist, den Sie mit einem einfachen GET abrufen können. Die Docs sagen nicht, wie Ihr Handler es herunterladen soll, also verallgemeinern Sie keine Annahmen. Erfassen Sie eine reale Lieferung und sehen Sie, was Ihre Jobs tatsächlich liefern. Googles eigene Beispiele prüfen außerdem, ob output_file_uri vorhanden ist, bevor es verwendet wird, mit einem Hinweis, der es mit Batch-Jobs verbindet, die aus einer Eingabedatei erstellt wurden. Gehen Sie nicht davon aus, dass das Feld in jedem batch.succeeded-Ereignis vorhanden ist.
Die anderen Gemini‑Batch‑Ereignisse tragen unterschiedliche Daten. batch.failed enthält error_code und error_message, während batch.cancelled und batch.expired nur die id tragen.
OpenAI’s Muster ähnelt dem. Das data-Objekt enthält nur die Batch-ID:
{
"id": "evt_abc123",
"type": "batch.completed",
"created_at": 1719168000,
"data": { "id": "batch_abc123" }
}
Um Ergebnisse zu erhalten, rufen Sie die Batch‑API auf, lesen Sie output_file_id aus dem Batch‑Objekt und laden Sie es über die Files‑API herunter. Lesen Sie error_file_id für fehlgeschlagene Anfragen. Vier Details sind hier wichtig:
- Ausgabedatenzeilen stimmen möglicherweise nicht mit der Eingabe überein; ordnen Sie die Ergebnisse mithilfe des
custom_idjeder Zeile zu. - Wenn ein Batch abläuft, bleiben die Antworten der abgeschlossenen Anfragen weiterhin in der Ausgabedatei verfügbar. Unerledigte Anfragen landen in der Fehlerdatei mit einem
batch_expired-Fehler, und Sie werden für die abgeschlossenen belastet. Ein Handler fürbatch.expiredsollte daher weiterhin nach Output suchen. - Das Abbrechen eines Batch verschiebt es zuerst in
cancelling, was bis zu 10 Minuten dauern kann, während laufende Anfragen beendet werden. Einbatch.cancelled-Ereignis ist nicht sofort. - Standardmäßig laufen Batch-Ausgabe- und Fehlerdateien 30 Tage nach Erstellung ab. Sie können dies beim Erstellen des Batch mit
output_expires_afterändern (1 Stunde bis 30 Tage).
Also ist das Webhook eine Benachrichtigung, und die eigentliche Arbeit erfolgt in einem zweiten Schritt. Diese Trennung ist der Schlüssel für kostengünstiges Debugging, weil Sie die beiden Hälften separat testen können.
Debuggen des Callbacks, ohne den Batch neu auszuführen
Hier ist ein Arbeitsablauf, der keine zweite Batch erfordert.
1. Erfassen Sie eine echte Lieferung. Senden Sie eine kleine Batch, und protokollieren Sie genau, was ankommt: Header und roher Body. Ein kleines Express-Rekorder macht das:
import express from "express";
import fs from "node:fs";
const app = express();
fs.mkdirSync("fixtures", { recursive: true });
// Keep the raw body: signature verification needs the exact bytes
app.use(express.text({ type: "application/json" }));
app.post("/hooks/:provider", (req, res) => {
fs.writeFileSync(
`fixtures/${req.params.provider}-${Date.now()}.json`,
JSON.stringify({ headers: req.headers, body: req.body }, null, 2)
);
res.sendStatus(200);
});
app.listen(3000);
Schnell mit 2xx antworten. Beide Provider versuchen es erneut, wenn Sie nicht innerhalb weniger Sekunden antworten, also notieren Sie sich zuerst und verarbeiten später. Fixtures enthalten Job-IDs und ggf. Ausgabestellen, daher speichern Sie sie nicht in Versionskontrollen.
2. Verifikation von der Verarbeitung trennen. Strukturieren Sie Ihren Code als verify(request) -> event gefolgt von handle(event). Dann können Sie gespeicherte Events direkt an handle() übergeben und Signaturprüfungen vollständig überspringen. Die Verifikations-Helfer existieren bereits. OpenAI‑SDKs bieten client.webhooks.unwrap(body, headers). Für Gemini Static Webhooks verwenden Googles Beispiele die standardwebhooks-Bibliothek. Für dynamische verifizieren Sie das JWT selbst.
Dieser Split ist besonders wichtig für Gemini Dynamic Webhooks. Sie können einen gespeicherten Delivery nicht nachsignieren, da Sie nicht Googles Private Key besitzen. Ein gespeicherter Token kann verifizieren scheitern, z. B. wenn er abläuft oder Google Schlüssel rotiert, und die Docs sagen nicht, wie lange Tokens gültig bleiben. Die Wiedereinspielung des geparsten Events in handle() vermeidet das Problem vollständig.
3. Normalisieren Sie die Ereignisnamen am Grenzpunkt. Ordnen Sie die Typ-Strings der Anbieter in eine einheitliche interne Terminologie zu, bevor Ihre Business-Logik sie sieht:
TERMINAL_STATUS = {
("openai", "batch.completed"): "succeeded",
("openai", "batch.failed"): "failed",
("openai", "batch.cancelled"): "cancelled",
("openai", "batch.expired"): "expired",
("gemini", "batch.succeeded"): "succeeded",
("gemini", "batch.failed"): "failed",
("gemini", "batch.cancelled"): "cancelled",
("gemini", "batch.expired"): "expired",
}
4. Beachten Sie das Frischefenster. Googles Best Practices empfehlen, Payloads abzulehnen, deren webhook-timestamp älter als fünf Minuten ist, um Replay-Angriffe zu verhindern. Ein gespeichertes Fixture, das eine Stunde später wiedergegeben wird, sollte von einem korrekten Handler abgelehnt werden. Für statische Gemini- und OpenAI‑Style-Signaturen signieren Sie Fixtures mit einem Test-Geheimnis neu und verwenden Sie einen frischen Timestamp, oder machen Sie die Toleranz in der Entwicklung konfigurierbar.
5. Den Pointer-Abruf stubs setzen. Legen Sie eine kleine Ausgabedatei auf die Festplatte und ersetzen Sie Ihre Files-API oder Storage-Lesekopf durch eine lokale Variante. Jetzt wird das Erfolg-Ereignis zu einem schnellen Offline-Test, der keine Cloud-Zugangsdaten benötigt.
6. Testen Sie die traurigen Pfade. Speichern Sie Fixtures für batch.failed, batch.expired und batch.cancelled ebenfalls, da Sie diese im echten Traffic selten sehen. Fügen Sie einen OpenAI‑Batch hinzu, der eine nicht-leere error_file_id hat. Schreiben Sie außerdem eine Duplikatl Lieferung mit derselben webhook-id, um Ihre Idempotenzprüfung zu bestätigen.
7. Verwenden Sie, wo vorhanden, Anbieter-Testwerkzeuge. OpenAI-Dashboard‑Webhook-Einstellungen können Testereignisse mit Muster-Daten senden, und die API-Referenz listet eine Methode „Test Webhook Endpoint“ auf. Gemini‑Webhook‑Dokumentation beschreibt kein Äquivalent, daher übernehmen Ihre aufgezeichneten Fixtures diese Aufgabe.
8. Abgleichen mit einer Abfrage. Wiederholungen sind endlich: 24 Stunden bei Gemini, bis zu 72 Stunden bei OpenAI. Wenn Ihr Endpunkt länger ausfällt, ist das Ereignis weg, und ein Batch kann selbst bis zu 24 Stunden dauern. Beim Start scannen Sie Ihr Aufgabenbuch nach Jobs, die noch als submitted markiert sind, und prüfen deren Status mit einem GET. Betrachten Sie Webhooks als schnellen Pfad und Polling als Sicherheitsnetz. Führen Sie dies durch, bevor die Ausgabedateien ablaufen, was standardmäßig 30 Tage bei OpenAI beträgt.
Ihr Ledger kann einfach sein: Job-ID, Anbieter, Status (submitted, succeeded, failed, cancelled, expired) und die zuletzt verarbeitete webhook-id. Die Docs beider Anbieter versprechen keine strikte Lieferreihenfolge; wenden Sie Updates nur an, wenn sie den Job vorwärts bringen, niemals rückwärts.
Wo eine stabile Tunnel-Subdomain hilft
Localhost ist weder von Google noch von OpenAI erreichbar, daher benötigen Sie eine öffentliche HTTPS-URL. OpenAI’s eigene Anleitung bestätigt das und schlägt Tools wie ngrok vor, sowie Cloud‑Entwicklungsumgebungen wie Replit, GitHub Codespaces, Cloudflare Workers und v0. Was für Batch-Arbeit zählt, ist, ob diese URL gleich bleibt.
- OpenAI‑Endpunkte und statische Gemini‑Webhooks werden einmal registriert. Wenn sich die URL bei jeder Sitzung ändert, befinden Sie sich wieder im Dashboard oder in der API, die es aktualisiert. Ein fester Hostname kann einmal registriert und unverändert belassen werden.
- Dynamische Gemini‑Webhooks legen die URL in jeden Job fest. Sie können einen stabilen Hostnamen in
webhook_config.urisin Ihren Einreichungscode integrieren, sodass jeder gestartete Job bereits nach Hause zeigt. - Vermeiden Sie Weiterleitungen an der registrierten URL. OpenAI folgt keinen
3xx-Antworten und behandelt sie als Fehler, registrieren Sie also die endgültige Ziel-URL. - Die Sitzungsdauer sollte mit dem Job-Horizont übereinstimmen. InstaTunnel’s README bewirbt ein kostenloses Tier mit 24+ Stunden-Sitzungen, benutzerdefinierte Subdomänen wie
my-app.instatunnel.my, und drei gleichzeitige Tunnel. Das veröffentlichte Pro‑Tier kostet 5 $/Monat. Prüfen Sie die aktuelle Preisübersicht, bevor Sie sich darauf verlassen. Eine Tunnel-Sitzung, die so lange dauert wie das 24‑Stunden‑Batchfenster, garantiert nicht, dass eine einzige Sitzung den ganzen Auftrag abdeckt. Provider-Retries bedeuten, dass eine kurze Neuverbindung das Ereignis nicht verliert, solange Sie am selben Adress zurückkehren.npm install -g instatunnel instatunnel 3000 --subdomain my-app # https://my-app.instatunnel.my -> localhost:3000
Eine Tunnel-Verbindung reicht aus, wenn Sie nach Pfad routen (/hooks/openai, /hooks/gemini-static, /hooks/gemini-dynamic). Ein separater Tunnel pro Integration ist optional, z. B. wenn Sie separate Logs möchten. Dass Gemini‑Dev-Projekt separat von Produktion zu halten, damit der statische Endpunkt nur Ihre eigenen Events erhält.
Checkliste vor dem Versand
- Ereignis-Namen explizit zuordnen:
batch.completed(OpenAI) undbatch.succeeded(Gemini). - Den rohen Body lesen, bevor irgendeine JSON‑Middleware ihn verändert.
- Schnell mit
2xxantworten, dann die eigentliche Arbeit in die Warteschlange. - Duplizieren anhand von
webhook-idund Duplikat-Records länger als das Retry-Fenster speichern (72 Stunden für OpenAI). - Prüfen Sie fehlgeschlagene Zeilen in einem “completed” OpenAI Batch über
error_file_id, und suchen Sie nach partiellen Ausgaben beibatch.expired. - Nicht davon ausgehen, dass
output_file_uribei jedem Gemini-Ereignis vorhanden ist, und prüfen Sie, was Ihre echten Lieferungen enthalten. - Zwei Verifizierer verwenden, wenn Sie beide Gemini‑Modelle nutzen, und JWKS cachen.
- Registrieren Sie keine URLs, die weiterleiten; OpenAI folgt ihnen nicht.
- Fügen Sie eine Abgleich-Abfrage für Jobs hinzu, die länger als Ihre Endpoint-Ausfallzeit leben.
Häufig gestellte Fragen
Arbeiten Gemini Webhooks mit der Batch-API?
Ja. Batch ist ein Hauptanwendungsfall, mit batch.succeeded, batch.failed, batch.cancelled und batch.expired-Ereignissen. Webhooks decken auch Interactions und Video-Generierung ab.
Sind Gemini Webhooks allgemein verfügbar?
Googles Launch-Post sagt, dass sie allen Entwicklern mit der Gemini API zur Verfügung stehen, aber die Dokumentation kennzeichnet das Feature derzeit als Preview. Prüfen Sie die Docs erneut, bevor Sie Details festlegen.
Was ist der Unterschied zwischen statischen und dynamischen Gemini-Webhooks?
Statische Webhooks sind projektweite Endpunkte, erstellt über die WebhookService‑API und mit einem HMAC‑Secret signiert. Dynamische Webhooks werden pro Anfrage über webhook_config festgelegt und mit einem JWT signiert, das Sie anhand von Googles öffentlichen Schlüsseln verifizieren.
Enthält der Webhook meine Batch-Ergebnisse?
Nein. Gemini sendet einen Verweis (wie output_file_uri im Google-Beispiel), und OpenAI sendet nur die Batch-ID, danach rufen Sie die Ausgabedatei ab.
Wie lange versuchen die Anbieter erneut?
Google versucht 24 Stunden lang mit exponentiellem Backoff erneut. OpenAI versucht bis zu 72 Stunden mit exponentiellem Backoff erneut.
Kann ich OpenAI-Webhooks testen, ohne einen Job auszuführen?
Ja. Die Dashboard‑Webhook‑Einstellungen können Testereignisse mit Muster-Daten senden.
Wird OpenAI einer Weiterleitung meiner Webhook-URL folgen?
Nein. 3xx-Antworten werden als Fehler behandelt, registrieren Sie also die endgültige Ziel-URL.
Fazit
Asynchrone KI‑Callbacks sind einfach zu empfangen und schwer zu debuggen, weil ihre Eingaben teuer zu reproduzieren sind. Erfassen Sie eine reale Lieferung, trennen Sie Verifikation von Verarbeitung, stubs den Abruf des Ergebnisses und halten Sie eine Polling‑Durchführung für alles, was länger als Ihr Retry‑Fenster lebt. Dann muss der Batch nur einmal laufen und alles danach ist eine Fixture.
Quellen
Related InstaTunnel pages
Continue from this article into the most relevant product guides and workflows.
Related Topics
Keep building with InstaTunnel
Read the docs for implementation details or compare plans before you ship.