Połączenie i użytkowanie

Gdy wywołanie zawodzi lub rozmowa zostaje przerwana, najpierw sprawdź minimalnym żądaniem trzy rzeczy: uwierzytelnienie, ścieżkę punktu końcowego i dostępność modelu.

Nie można połączyć się z platformą?

Sprawdź:

• Czy klucz API jest poprawnie skonfigurowany, bez dodatkowych spacji lub znaków nowej linii.
• Czy bazowy adres URL jest poprawny i nie zawiera zdublowanych ścieżek.
• Czy ścieżka punktu końcowego odpowiada protokołowi klienta, na przykład ścieżka zgodna z OpenAI dla klientów OpenAI.
• Czy sieć lokalna, firmowe proxy, zapora, DNS lub inspekcja HTTPS nie blokują żądań.
• Czy klucz API nie wygasł, nie został usunięty lub nie należy do konta z ograniczeniami.

Dla wywołań zgodnych z OpenAI przetestuj minimalne żądanie bez strumieniowania:

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
  }'

Jeśli minimalne żądanie zawodzi, problem zwykle dotyczy sieci, uwierzytelnienia, konfiguracji ścieżki, uprawnień do modelu lub statusu konta.

Wybrano model, ale brak odpowiedzi lub występuje błąd?

Typowe przyczyny:

• Identyfikator modelu jest nieprawidłowy lub nie odpowiada liście modeli platformy.
• Wybrany model jest tymczasowo niedostępny lub niedozwolony dla klucza API.
• Format żądania jest nieprawidłowy, na przykład błędne nazwy pól, zagnieżdżenie lub typy.
• Konto ma niewystarczające saldo, kontekst lub wynik jest zbyt długi albo usługa przekroczyła limit czasu.
• Klient zewnętrzny nie obsługuje prawidłowo strumieniowania lub odpowiedzi błędów.

Skopiuj dokładny identyfikator modelu z konsoli lub listy modeli, przetestuj minimalną treść, a następnie stopniowo przywracaj kontekst i parametry.

Co zrobić, gdy czat zgłasza błąd lub się rozłącza?

Ustal etap błędu:

• Przed rozpoczęciem żądania: sprawdź uwierzytelnienie, ścieżkę, model i parametry.
• Podczas strumieniowania: sprawdź limit czasu klienta, łańcuch proxy i parsowanie SSE.
• Przy długim kontekście lub wyniku: sprawdź rozmiar żądania, limity wyniku i limit czasu usługi.

Zalecane postępowanie:

1. Odczytaj konkretne pola błędu.
2. Tymczasowo wyłącz strumieniowanie, aby odróżnić błąd modelu od błędu parsowania strumienia.
3. Dodaj ponawianie ze zwiększanym odstępem dla 429, niestabilności sieci i niektórych błędów 5xx.
4. Przy ponowieniach dołącz wymagany kontekst zamiast zakładać stan rozmowy po stronie serwera.
5. Zapisz X-Request-ID, jeśli problem nadal występuje.