Verbindung und Nutzung

Schlägt ein Aufruf fehl oder wird ein Gespräch unterbrochen, prüfen Sie zunächst mit einer minimalen Anfrage drei Dinge: Authentifizierung, Endpunktpfad und Modellverfügbarkeit.

Keine Verbindung zur Plattform möglich?

Prüfen Sie:

• Ist der API-Schlüssel korrekt und ohne zusätzliche Leerzeichen oder Zeilenumbrüche konfiguriert?
• Ist die Basis-URL korrekt und ohne doppelte Pfade?
• Passt der Endpunktpfad zum Clientprotokoll, etwa der OpenAI-kompatible Pfad für OpenAI-Clients?
• Blockieren lokales Netzwerk, Unternehmensproxy, Firewall, DNS oder HTTPS-Prüfung die Anfragen?
• Ist der API-Schlüssel abgelaufen, gelöscht oder einem eingeschränkten Konto zugeordnet?

Testen Sie OpenAI-kompatible Aufrufe mit einer minimalen Anfrage ohne Streaming:

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Schlägt die minimale Anfrage fehl, liegt die Ursache gewöhnlich bei Netzwerk, Authentifizierung, Pfadkonfiguration, Modellberechtigungen oder Kontostatus.

Modell gewählt, aber keine Antwort oder ein Fehler?

Häufige Ursachen:

• Die Modell-ID ist falsch oder stimmt nicht mit der Plattformliste überein.
• Das Modell ist vorübergehend nicht verfügbar oder für den API-Schlüssel nicht erlaubt.
• Das Anfrageformat ist ungültig, etwa durch falsche Feldnamen, Verschachtelung oder Typen.
• Das Kontoguthaben reicht nicht, Kontext oder Ausgabe sind zu lang oder der Dienst hat das Zeitlimit überschritten.
• Der Drittanbieterclient verarbeitet Streaming oder Fehlerantworten nicht korrekt.

Kopieren Sie die genaue Modell-ID aus Konsole oder Modellliste, testen Sie einen minimalen Anfrageinhalt und ergänzen Sie Kontext und Parameter schrittweise.

Was tun bei Chatfehlern oder Verbindungsabbrüchen?

Bestimmen Sie die Fehlerstelle:

• Vor Beginn der Anfrage: Authentifizierung, Pfad, Modell und Parameter prüfen.
• Während des Streamings: Client-Zeitlimit, Proxykette und SSE-Verarbeitung prüfen.
• Bei langem Kontext oder langer Ausgabe: Anfragegröße, Ausgabelimits und Dienst-Zeitlimit prüfen.

Empfohlene Behandlung:

1. Lesen Sie die konkreten Fehlerfelder.
2. Wechseln Sie vorübergehend zu Antworten ohne Streaming, um Modellfehler von Streaming-Verarbeitungsfehlern zu unterscheiden.
3. Ergänzen Sie Wiederholungen mit Wartezeit für 429, instabile Netzwerke und einige 5xx-Fehler.
4. Senden Sie bei Wiederholungen den nötigen Kontext mit, statt einen serverseitigen Gesprächszustand vorauszusetzen.
5. Notieren Sie X-Request-ID, wenn das Problem bleibt.