Autorhinweis: Die Dokumentation zur APIYI-Request-ID-Abfrage wurde überarbeitet. Dieser Artikel erklärt genau, welche Zeichenkette bei einer Fehlermeldung kopiert werden muss, welche IDs nicht verwendet werden können, wie die task_id asynchroner Videoaufträge gespeichert wird und welche Angaben nachzureichen sind, wenn im Log nichts zu finden ist.
Wenn nach einem Aufruffehler ein Ticket erstellt wird, hängen Entwickler oft am selben Problem: Sie haben zwar eine ID-Zeichenkette zur Hand, doch der Support findet sie im Log nicht. Der Grund ist meist, dass die X-Request-Id des vorgelagerten Originalherstellers kopiert wurde und nicht die APIYI-eigene X-Shellapi-Request-Id. Die neue Version der Dokumentation wurde genau zur Lösung dieses Problems neu geschrieben, die Adresse lautet docs.apiyi.com/faq/request-id-troubleshooting.
Das ist keine bloße Überarbeitung der Verpackung. Die alte Version begann bei den „Response-Headern“ und war voll von „in der Regel“ und „möglicherweise“ – nach dem Lesen wusste man trotzdem nicht, wo man kopieren soll. Die neue Version dreht die Reihenfolge um: erst die Antwort, dann die Vorgehensweise, zuletzt die Ticket-Vorlage.
Der Kernnutzen: Nach dem Lesen dieses Artikels bekommen Sie die richtige Request ID in 10 Sekunden und erkennen auch, welche IDs falsch sind. Wenn im Log kein Eintrag zu finden ist, wissen Sie zudem, welche Angaben Sie nachreichen müssen.

Was sich am Request-ID-Dokument von APIYI geändert hat
Der erste Satz der neuen Doku liefert direkt die Antwort: Die Request ID bei APIYI ist der X-Shellapi-Request-Id im Response-Header – und bei Fehlern steht derselbe Wert auch am Ende der Fehlermeldung. Ein paar Formulierungen auf der alten Seite, die x-request-id noch als „notieren, damit man bei der Fehlersuche leichter ist“ beschrieben haben, wurden bei dieser Gelegenheit gleich mit korrigiert.
| Information | Details |
|---|---|
| Aktualisiert am | 2026-11-16 |
| Ort der Doku | FAQ-Bereich, neue Seite „Request-ID-Fehlersuche“ |
| Kernaussage | Request ID = Response-Header X-Shellapi-Request-Id; das (request id: ...) am Ende der Fehlermeldung ist derselbe Wert |
| Neue Inhalte | 2 Methoden zum Auslesen, ID-Zuordnungstabelle, Konsolen-Logs zeigen die ID nicht an, Erläuterung zu asynchronen Videos, was tun, wenn sie nicht auffindbar ist, Ticket-Vorlage |
| Sicherheitshinweis | Die Request ID ist kein Schlüssel und darf in Tickets, Chats und Screenshots kopiert werden; nicht herausgeben darf man den vollständigen API-Schlüssel, der mit sk- beginnt |
| Betroffener Personenkreis | Alle Entwickler, die bei APIYI Text-, Bild-, Embedding-, Claude-Messages-, Responses- und asynchrone Video-Schnittstellen aufrufen |
Laut Doku ist der Name dieses Response-Headers nicht case-sensitiv. Er wird bei erfolgreichen Anfragen, bei Fehlerantworten und bei Streaming-Requests zurückgegeben; bei einem Streaming-Request kommt der Response-Header noch vor dem ersten Datenblock an. Auch das Absenden und Abfragen über die asynchrone Video-Schnittstelle liefert ihn zurück.
APIYI Request ID – welche Zeichenkette Sie jetzt kopieren sollten: zwei Wege
Prüfen Sie zuerst das Format: Eine Request ID von APIYI beginnt mit einem 14-stelligen UTC-Zeitstempel. Beispiel: 2026111602224568279882196e93ae3kTS58ypN – die ersten 14 Zeichen 20261116022245 stehen für den 2026-11-16 02:22:45 UTC, also 10:22:45 Pekinger Zeit. Vergleichen Sie diesen Präfix mit dem Zeitpunkt Ihres eigenen Aufrufs, damit lässt sich meist schnell erkennen, ob Sie die falsche Zeichenkette erwischt haben.

Weg eins: direkt aus dem Fehler-JSON kopieren
Dieser Weg passt für die meisten Client-Nutzer. Wenn ein Fehler auftritt, hängt am Ende des Feldes message im Fehler-JSON ein Abschnitt (request id: ...) – kopieren Sie einfach die Zeichenkette in der Klammer vollständig.
- Suchen Sie im Client oder in der Log-Ausgabe das vollständige Fehler-JSON.
- Finden Sie das Ende des Feldes
message. - Kopieren Sie die gesamte Zeichenkette hinter
request id:, ohne sie abzuschneiden.
Konsolenprotokoll: Aufrufe bestätigen, aber keine Request ID anzeigen
Viele suchen zuerst auf der „Logs“-Seite der Konsole nach der ID. Die neue Dokumentation widmet diesem Punkt einen eigenen Abschnitt: Die Logs-Seite zeigt X-Shellapi-Request-Id nicht an und bietet auch keine Suchmöglichkeit danach.
In den Logs sieht man Zeit, Modell, Tokenname, Streaming/Nicht-Streaming, Dauer, Status, Eingabe-/Ausgabe-Token, Kosten, Gruppe, Multiplikator und IP. Damit lässt sich ausreichend bestätigen, ob dieser Aufruf APIYI erreicht hat, welches Modell verwendet wurde und wie viel abgerechnet wurde – für eine belastbare Fehlerdiagnose taugt es jedoch nicht.
Bei einer Fehlermeldung gibt es daher nur zwei Quellen für die ID: den Fehlertext selbst (Weg 1) und die Response-Header (Weg 2). Die Logs dienen dazu, die Angaben zu Zeit, Modell, Token und Kosten zu ergänzen.
Weg 2: Response-Header im Code auslesen
Bei der automatisierten Sammlung von Fehlermeldungen empfiehlt es sich, diesen Header direkt im Code zu protokollieren. Die Base URL ist bei allen Methoden https://api.apiyi.com/v1.
- cURL: Mit
curl -D headers.txtdie Response-Header in eine Datei schreiben und dort nachx-shellapi-request-idsuchen. Für eine schnelle Diagnose kann man auchcurl -iverwenden, um sie direkt auszugeben. - Python requests: Nach Erhalt des Response-Objekts
r.headers.get("x-shellapi-request-id")auslesen. Das funktioniert sowohl bei Erfolg als auch bei Fehlern. - OpenAI SDK (Python): Der
_request_idin normalen Rückgabewerten liestx-request-id, das bei APIYI in der Regel leer ist. Richtig ist, aufclient.chat.completions.with_raw_response.create(...)umzustellen,raw.headers.get("x-shellapi-request-id")auszulesen und das Ergebnis anschließend mitraw.parse()zu holen. Bei Fehlern inexcept openai.APIStatusError as edie Header übere.response.headersauslesen. - Node.js: Bei fetch
res.headers.get("x-shellapi-request-id")auslesen. - Postman: Nach dem Senden im Response-Bereich den Tab Headers öffnen und
X-Shellapi-Request-Idfinden. - Browser-Frontend: Bei Cross-Origin-Aufrufen greift die CORS-Beschränkung; JS kann diesen Header nicht lesen. Man kann ihn im Backend-Proxy protokollieren oder in den Entwicklertools unter Network → die Anfrage → Response Headers nachsehen.
🚀 Schnellstart: Um zu prüfen, ob der eigene Code diesen Header lesen kann, kann man mit einem Token von APIYI apiyi.com eine minimale Anfrage senden und sehen, ob eine ID ausgegeben wird, die mit einem 14-stelligen Zeitstempel beginnt. Dieser Schritt verbraucht einige Token; wählen Sie daher eine Eingabeaufforderung mit sehr kurzer Ausgabe.
Welche IDs keine APIYI-Request-ID sind
In einer einzigen Antwort können durchaus mehrere verschiedene „IDs“ gleichzeitig auftauchen – und genau daran hängen viele Support-Tickets. Die neue Dokumentation enthält eine Vergleichstabelle; die Kernpunkte fassen wir hier zusammen.

| Feld | Quelle | Für Fehlerberichte bzw. Log-Suche geeignet | Erkennungsmerkmal |
|---|---|---|---|
| X-Shellapi-Request-Id | APIYI | ✅ Genau diese | Beginnt mit 14-stelliger UTC-Zeit |
| X-Oneapi-Request-Id | Zwischenschicht | ❌ | Anderer Header-Name |
| X-Request-Id | Upstream-Hersteller | ❌ In den APIYI-Logs nicht zu finden | Häufig mit req_ beginnend oder UUID |
| Benutzerdefinierte Header anderer Kanäle | Kanal | ❌ | Unterschiedliche Header-Namen |
Response-Body-id |
Completion ID / Response ID | ❌ | Beginnt mit chatcmpl- oder resp_ |
generation_id des Bildes |
Ergebnis der Bilderzeugung | ❌ | Steht im Response-Body |
task_id |
Asynchrone Aufgabe | ❌ Keine Request ID, muss aber mit angegeben werden | Für Aufgabenabfrage und Prüfung der Abbuchung |
Die Regel ist denkbar einfach: Was nicht mit einer 14-stelligen Zeitangabe beginnt, ist keine Request ID von APIYI. Wenn Sie eine ID erhalten, die mit req_ beginnt, wurde die Anfrage möglicherweise direkt an OpenAI geschickt. Prüfen Sie in diesem Fall zuerst, ob die Base URL auf https://api.apiyi.com/v1 gesetzt ist.
So speichern Sie task_id und Request-ID bei asynchronen Videos getrennt
Asynchrone Videos haben zwei Schritte – „Übermitteln“ und „Abfragen“ –, und jeder Schritt gibt eine neue X-Shellapi-Request-Id zurück. Dazu kommt noch eine Task-ID, was schnell zu Verwechslungen führt. Die aktualisierte Dokumentation empfiehlt: Die Request-ID der Übermittlung und die Task-ID für das Polling getrennt speichern.
| Modell | Position der Task-ID | Abfrage-Endpunkt | Leicht zu verwechselndes Feld |
|---|---|---|---|
| Seedance | Oberste Ebene des Response-Bodys: id (das Feld heißt nicht task_id) |
GET /seedance/api/v3/contents/generations/tasks/{id} |
— |
| Wan / HappyHorse | output.task_id |
GET /v1/tasks/{task_id} |
Das request_id im Response-Body stammt vom Upstream und ist nicht das aus den APIYI-Logs. |
Für die tatsächliche Speicherung empfiehlt es sich, pro Task drei Felder abzulegen: die X-Shellapi-Request-Id der Übermittlung, die Task-ID und den Übermittlungszeitpunkt. Die bei der Task-Abfrage zurückgegebene Request-ID kann bei Bedarf mitgespeichert werden. Bei einer fehlgeschlagenen Übermittlung verwendet man für die Fehlermeldung an den Support die Request-ID; wenn ein Task hängt oder es Fragen zur Abrechnung gibt, werden sowohl für die Task-Abfrage als auch für die Abrechnungsprüfung die Task-ID benötigt.
Was man ergänzt, wenn die Request ID im Log nicht auffindbar ist
Auch mit ID in der Hand heißt das noch nicht, dass sie im Log zu finden ist. Die neue Version der Dokumentation widmet dem Fall „keine Request ID im Konsolen-Log“ einen eigenen Abschnitt; die übrigen Situationen, in denen sich nichts findet, lassen sich entsprechend behandeln.
| Situation | Ursache | Was zu ergänzen ist |
|---|---|---|
| Anfrage scheitert, bevor eine Antwort eintrifft | DNS, TCP/TLS, Proxy-Ablehnung, Client-Timeout – es gibt überhaupt keinen Antwort-Header | Original-Fehlertext, Aufrufzeit, Beschreibung der Netzwerkumgebung |
| Client zeigt nur „Request failed“ | Der Client gibt den ursprünglichen Fehler nicht preis | ID über Weg eins oder Weg zwei ermitteln; das Log bestätigt nur, ob der Aufruf angekommen ist |
ID beginnt mit req_ |
Womöglich wurde die offizielle OpenAI-Schnittstelle getroffen | Base URL prüfen und erneut versuchen |
| Auch im Log nicht auffindbar | Aufbewahrungsfrist überschritten oder falsche ID | ID-Format prüfen; das Log bewahrt nur den aktuellen und die beiden vorangegangenen Kalendermonate auf |
Noch ein Punkt: Die Konsolenseite zeigt keine ID an, aber die Log-Abfrage-API lässt sich nach request_id durchsuchen. Die folgende Tabelle ist die Überprüfung eines echten Aufrufs vom 2026-11-16 mit den Modellen deepseek-flash und gpt-image-2; die Anfrage ging an https://api.apiyi.com/v1.
| Aufruf | HTTP-Status | Antwort-Header | Ergebnis der Log-Abfrage nach request_id |
|---|---|---|---|
| deepseek-flash, nicht streamend | 200 | x-shellapi-request-id vorhanden, x-request-id nicht | genau 1 Verbrauchsdatensatz gefunden |
| deepseek-flash, streamend | 200 | vorhanden, bereits vor dem ersten data:-Block lesbar |
— |
| gpt-image-2, size=999×999 | 400 | identisch mit der request id am Ende der message | 3 Fehler-/Wiederholungszeilen, keine Verbrauchszeile |
| nicht existierender Modellname | 503 | identisch mit der request id am Ende der message | keine einzige Zeile auffindbar |
Das Fazit: Die Log-Seite der Konsole zeigt keine Request ID an, aber die Log-Abfrage-API findet über request_id sowohl „Verbrauchszeilen“ als auch „Fehlerzeilen“ – und das nicht immer garantiert. Anfragen, die den Kanal bereits erreicht haben und erst dort fehlschlagen (etwa wegen fehlerhafter Parameter), hinterlassen eine Fehlerzeile. Solche, die direkt am Gateway abgelehnt werden (etwa weil kein Kanal verfügbar ist), hinterlassen womöglich keine einzige Zeile. Findet man nichts, ergänzt man die Unterlagen mit der ID aus dem Antwort-Header oder dem Original-Fehlertext plus der Aufrufzeit.
Wenn der Support den Fehler reproduzieren muss, kann man auf APIYI apiyi.com mit demselben Token und denselben Parametern erneut aufrufen oder ein anderes Modell verwenden, um zu vergleichen, ob es derselbe Fehler ist. Auch eine Reproduktion verbraucht Token – also die Request ID jeder Reproduktion mit protokollieren.
🎯 Tipp zur Fehlersuche: Beim Reproduzieren des Fehlers die Base URL fest auf
https://api.apiyi.com/v1setzen und jedes Mal X-Shellapi-Request-Id und die Aufrufzeit notieren. Danach beides zusammen an den Support geben; das Backend sucht dann nach der ID und kann schneller feststellen, ob der Fehler am Gateway oder am Kanal aufgetreten ist.
APIYI Request-ID-Fehler-Ticket-Vorlage
Die folgenden Felder können Sie direkt in das Ticket kopieren und ausfüllen:
- Request ID: die Zeichenkette, die mit einem 14-stelligen Zeitstempel beginnt
- Modell: z. B. gpt-image-2
- Schnittstelle: z. B. POST /v1/chat/completions
- Zeit: mit Zeitzone, z. B. 2026-11-16 11:24:04 UTC+8
- HTTP-Status: z. B. 400 / 503
- Fehlermeldung: die vollständige Fehlermeldung einfügen, einschließlich
(request id: ...) - Bereits versucht: z. B. Modell bereits gewechselt, Base URL bereits geprüft, bereits 2-mal erneut versucht
- task_id (nur bei asynchronen Videos): die bei der Übermittlung zurückgegebene Task-ID
Zwei Hinweise: Senden Sie niemals den vollständigen API-Schlüssel; wenn der Request-Body oder die Bilder private Inhalte enthalten, anonymisieren Sie diese vor dem Einreichen.
Auswirkungen des Request-ID-Dokumentationsupdates auf Entwickler
Auswirkungen auf Entwickler
- Weniger Rückfragen bei Fehlermeldungen: Wenn die ID gleich richtig angegeben wird, muss der Support nicht noch einmal nachhaken.
- SDK-Nutzer erhalten keine leeren Werte mehr: Die Fallstricke bei
_request_idund die korrekte Verwendung vonwith_raw_responsesind jetzt klar dokumentiert. - Video-Tasks bleiben nachvollziehbar: Request ID und Task-ID getrennt speichern – so gibt es eine Grundlage für die Nachverfolgung von Tasks und Abrechnung.
Wichtig beim Lesen älterer Dokumentation
Auf einigen Seiten zu Schnittstellenfunktionen, auf News-Seiten und auf Seiten zur Fehleraufbewahrung wird x-request-id immer noch als etwas beschrieben, das man „zur einfacheren Fehlersuche notieren“ sollte. Wenn Sie auf solche Formulierungen stoßen, gilt die neue Seite zur Request ID. Ersetzen Sie in Code-Vorlagen x-request-id ebenfalls durch x-shellapi-request-id.
Häufig gestellte Fragen (FAQ)
F1: Welche Request ID ist bei APIYI die richtige?
Es ist die `X-Shellapi-Request-Id` im Response-Header, die mit einem 14-stelligen UTC-Zeitstempel beginnt. Bei Fehlern ist der Wert am Ende der Fehlermeldung `(request id: …)` identisch damit.
F2: Ist es sicher, die Request ID an andere weiterzugeben?
Ja, sicher. Laut Dokumentation ist die Request ID kein Schlüssel und darf in Tickets, Chats oder Screenshots eingefügt werden. Was Sie nicht weitergeben dürfen, ist der vollständige API Key, der mit `sk-` beginnt.
F3: Warum ist die ID, die das OpenAI SDK ausliest, leer?
Das Standard-`_request_id` des SDK liest `x-request-id` aus. Verwenden Sie stattdessen `with_raw_response` oder holen Sie `x-shellapi-request-id` aus den Response-Headern der `APIStatusError`.
F4: Wie kann ich schnell prüfen, ob ich die richtige Request ID erhalte?
1. Registrieren Sie sich bei APIYI auf apiyi.com und holen Sie sich einen API Key – neue Nutzer erhalten ein kostenloses Testkontingent.
2. Setzen Sie die Base URL auf `https://api.apiyi.com/v1` und senden Sie eine minimale Anfrage.
3. Geben Sie `x-shellapi-request-id` aus und prüfen Sie, ob Sie diese ID bei jedem Aufruf erhalten. Die Log-Seite dient nur dazu zu prüfen, ob der Aufruf angekommen und abgerechnet wurde – sie zeigt die ID nicht an.
F5: Kann ich einen Fehler von vor drei Monaten noch nachschauen?
In der Regel nicht. Die Logs werden für den aktuellen und die beiden vorangegangenen Kalendermonate aufbewahrt. Für ältere Einträge müssen Sie sich auf die selbst gespeicherte Request ID und den Originaltext der Fehlermeldung berufen.
APIYI Request ID – die Kernpunkte (Key Takeaways)
- Die einzig korrekte ID: X-Shellapi-Request-Id, sie beginnt mit einem 14-stelligen UTC-Zeitstempel
- Zwei Wege, sie zu bekommen: aus der Fehlermeldung kopieren oder im Code den Antwort-Header auslesen (Logs bestätigen nur den Aufruf, sie zeigen die ID nicht an)
- Häufig falsch gegriffen: X-Request-Id,
req_,chatcmpl-,resp_und UUIDs taugen nicht für Fehlerberichte - Bei Videos zwei Werte speichern: die übermittelte Request ID und die Task-ID getrennt ablegen
- Logs sind keine Garantie: Die Konsole zeigt die ID nicht an; Requests, die das Gateway sofort ablehnt, tauchen unter Umständen gar nicht auf – dann Fehlertext und Zeitpunkt nachreichen
- Schnelltest: einmal eine minimale Anfrage an APIYI auf apiyi.com senden – damit ist klar, ob sich dieser Header auslesen lässt
Fazit
Das Update der APIYI-Dokumentation zur Request-ID-Abfrage lässt sich auf drei Punkte herunterbrechen:
- Antwort zuerst: Die Request ID ist die X-Shellapi-Request-Id – derselbe Wert steht auch am Ende der Fehlermeldung.
- Falsche IDs aussortieren: Eine Vergleichstabelle macht die Unterschiede zwischen Zwischenschicht, Upstream, Response-Body und Task-ID deutlich.
- Plan B, wenn nichts gefunden wird: Für vier Szenarien steht drin, welche Angaben jeweils nachzureichen sind – inklusive einer direkt nutzbaren Ticket-Vorlage.
Am besten stellen Sie das Fehler-Logfeld im Code jetzt auf x-shellapi-request-id um. Wenn dann ein Problem auftritt, geben Sie dem Support die ID zusammen mit dem Aufrufzeitpunkt; das Backend sucht anhand der ID, und Sie reichen anschließend mit vollständigen Unterlagen ein Ticket ein.
📚 Referenzen
- APIYI-Dokumentation zur Fehlerbehebung bei Request-IDs (neue Version): Grundlage der Fakten in diesem Artikel
- Link:
docs.apiyi.com/faq/request-id-troubleshooting -
Beschreibung: Enthält zwei Methoden zum Abrufen, Erläuterungen zu Konsolenprotokollen, eine ID-Zuordnungstabelle, Hinweise zu asynchronen Videos und eine Ticket-Vorlage
-
Wie lange werden Protokolle gespeichert?: Erläuterung zur Aufbewahrungsdauer von Protokollen
- Link:
docs.apiyi.com/faq/log-retention-policy - Beschreibung: Bestätigt, ob Fehlerprotokolle noch abgerufen werden können
Autor: APIYI-Team
Technischer Austausch: Kontaktieren Sie uns gerne über die Startseite von APIYI apiyi.com. Wenn Sie beim Einreichen eines Tickets die X-Shellapi-Request-Id angeben, kann die Bearbeitung beschleunigt werden.
