Häufige Fragen zur API-Anbindung

Schnelle Übersicht über häufige Fragen zu Base URL, Modellen, Streaming, Clients, Timeouts und Verfügbarkeitsüberwachung.

Adresse, Schlüssel und Modelle

Muss die Base URL /v1 enthalten oder nicht?

Im OpenAI SDK https://1zheai.com/v1 eintragen; im Anthropic SDK und in Claude Code https://1zheai.com eintragen. Bei direkter Verwendung von curl den vollständigen Anfragepfad angeben. Einige Desktop-Tools ergänzen den Pfad automatisch, siehe Adressübersichtstabelle .

Ich habe ein ChatGPT- oder Claude-Abo – brauche ich trotzdem einen Schlüssel von dieser Seite?

Ja. Für die Anbindung an diese Website wird ein in der Konsole dieser Website erstellter API-Schlüssel verwendet; die Abonnements von Verbraucher-Clients sind ein anderer Zugangsweg als die API-Zugangsdaten dieser Website. Das Tool muss außerdem einen benutzerdefinierten Anbieter- oder API-Adresse unterstützen.

Das Modell steht in der Liste, warum schlägt der Aufruf trotzdem fehl?

Die Liste zeigt die Modelle, die für den aktuellen Schlüssel sichtbar sind, nicht die Echtzeit-Inferenz-Erfolgsquote. Prüfen Sie zusätzlich das Schnittstellenprotokoll, die optionalen Parameter und den Upstream-Status, siehe Modell-Abfrage-API .

Kann ich Modellnamen von anderen Plattformen einfach übernehmen?

Die vollständige ID aus der Modellliste dieser Website kopieren. Verschiedene Anbieter verwenden möglicherweise unterschiedliche Präfixe, Aliase und Datumsversionen; raten Sie keine umbenannten Modelle. Migrationsanleitung siehe Migrationsleitfaden .

Anfragen und Clients

Aufruf erfolgreich, aber ich erhalte keinen Text?

Zuerst das Antwortprotokoll bestätigen. Chat Completions liest choices[].message.content, Messages iteriert über content-Textblöcke, Responses iteriert über output oder verwendet das output_text des SDK. Tool-Call-Antworten enthalten möglicherweise ebenfalls keinen normalen Text.

Warum wurde der Inhalt der vorherigen Runde nicht gespeichert?

Mehrstufige Dialoge erfordern, dass der Client die Historie übermittelt. Wiederholte Verwendung desselben Schlüssels erstellt nicht automatisch eine serverseitige Sitzung. Sitzungsbezogene Erweiterungen von Responses müssen separat auf Unterstützung geprüft werden; verlassen Sie sich nicht standardmäßig darauf.

Ich habe im Streaming Text erhalten – gilt das als erfolgreich?

Zusätzlich müssen das Endereignis oder der Endzustand bestätigt werden. Fehler in der Mitte, unterbrochene Streams und abgeschnittene Ausgaben können auftreten, nachdem bereits teilweise Text empfangen wurde. Details siehe Streaming-Ausgabe .

Darf ich nach einem Timeout unbegrenzt wiederholen?

Nicht empfohlen. Timeouts können auftreten, nachdem die Anfrage bereits verarbeitet wurde. Prüfen Sie zuerst die Aufrufprotokolle und führen Sie dann Wiederholungen mit begrenzter Anzahl, Backoff und Gesamtwartezeit durch, um zu vermeiden, dass SDK und Anwendung jeweils eine Wiederholungsrunde ausführen. Siehe Timeouts und Wiederholungen .

Kann ich den API-Schlüssel direkt im Web-Frontend platzieren?

Kompilieren Sie den Schlüssel nicht in Browser-Skripte oder öffentliche Repositories. Lassen Sie Ihren Server die Zugangsdaten halten und die API aufrufen; der Browser verbindet sich nur mit Ihrem eigenen Backend. Umgebungsvariablen in Beispielcode dienen dem Server oder dem lokalen Terminal.

Service-Status und Hilfe

Die Laufzeitüberwachung ist normal – warum meldet das Modell trotzdem einen Fehler?

Die Überwachung prüft die HTTP-Erreichbarkeit der Website, der Konsole und des API-Eingangs und stellt nicht die Inferenz-Erfolgsquote jedes einzelnen Modells dar. Die Überwachung läuft auf demselben Server wie die Anwendung; bei einem Gesamtausfall des Servers wird auch die Überwachung pausiert; historische Daten werden ab der Aktivierung kumuliert.

Was sollte ich vor dem Kontakt mit dem Support vorbereiten?

Geben Sie Zeitpunkt und Zeitzone, Client-Version, Modell-ID, vollständigen Anfragepfad, HTTP-Statuscode, Anfrage-ID und die bereinigte Fehlermeldung an. Entfernen Sie Schlüssel, Authentifizierungs-Header und private Gesprächsinhalte; Sie können die Fehleranalysevorlage verwenden.