Rozwiązywanie problemów

Ten przewodnik zawiera rozwiązania typowych problemów, które mogą wystąpić podczas korzystania z Qwen Image Edit. Jeśli nie możesz znaleźć rozwiązania swojego problemu tutaj, skontaktuj się z naszym zespołem wsparcia.

1. Ogólne problemy

Nieprawidłowy klucz API

Problem: Otrzymujesz błąd 401 Unauthorized lub INVALID_API_KEY.

Rozwiązanie:

1. Upewnij się, że Twój klucz API jest poprawny i nie zawiera literówek.
2. Sprawdź, czy Twój klucz API jest aktywny w konsoli Qwen Image Edit.
3. Upewnij się, że przekazujesz klucz API w nagłówku Authorization jako token Bearer.

Przekroczono limit szybkości

Problem: Otrzymujesz błąd 429 Too Many Requests.

Rozwiązanie:

1. Sprawdź swoje aktualne limity szybkości w konsoli Qwen Image Edit.
2. Zaimplementuj wykładnicze wycofywanie w swoim kodzie, aby ponawiać żądania z opóźnieniem.
3. Jeśli potrzebujesz wyższych limitów szybkości, skontaktuj się z naszym zespołem wsparcia.

Nieprawidłowy format obrazu

Problem: Otrzymujesz błąd wskazujący na nieobsługiwany format obrazu lub uszkodzony plik.

Rozwiązanie:

1. Upewnij się, że Twój obraz wejściowy jest w obsługiwanym formacie (np. JPEG, PNG, WebP).
2. Sprawdź, czy adres URL obrazu jest dostępny i obraz nie jest uszkodzony.
3. Sprawdź, czy nagłówek Content-Type jest poprawnie ustawiony dla Twoich żądań.

2. Błędy uwierzytelniania

• 401 Unauthorized: Brak lub nieprawidłowy klucz API.

  • Sprawdź: Poprawność klucza API i jego przekazanie w nagłówku Authorization: Bearer YOUR_API_KEY.

• 403 Forbidden: Klucz API nie ma wystarczających uprawnień.

  • Sprawdź: Uprawnienia związane z Twoim kluczem API w konsoli Qwen Image Edit. Może być konieczne wygenerowanie nowego klucza z wymaganymi uprawnieniami.

3. Problemy z limitami i kwotami

• 429 Too Many Requests: Przekroczyłeś limit szybkości dla swojego planu.

  • Rozwiązanie: Zaimplementuj logikę ponawiania z wykładniczym wycofaniem. Rozważ uaktualnienie swojego planu, jeśli stale potrzebujesz wyższych limitów.

• 402 Payment Required: Przekroczyłeś swój miesięczny limit.

  • Rozwiązanie: Sprawdź wykorzystanie limitu w konsoli Qwen Image Edit. Uaktualnij swój plan lub poczekaj na zresetowanie limitu.

4. Problemy związane z obrazami

• Obraz nie znaleziony lub niedostępny: API nie może uzyskać dostępu do podanego adresu URL obrazu.

  • Sprawdź: Dostępność adresu URL obrazu z publicznego internetu. Upewnij się, że nie ma problemów z CORS lub zaporą sieciową.

• Nieprawidłowy rozmiar lub rozdzielczość obrazu: Obraz nie spełnia wymagań dotyczących rozmiaru lub rozdzielczości.

  • Sprawdź: Dokumentację pod kątem minimalnych/maksymalnych rozmiarów i rozdzielczości obrazu. Zmień rozmiar obrazu odpowiednio.

• Problemy z przetwarzaniem obrazu: Błędy podczas stosowania operacji edycji.

  • Sprawdź: Poprawność parametrów edycji. Upewnij się, że żądane operacje są zgodne z obrazem wejściowym.

5. Problemy z siecią

• Limit czasu połączenia: Żądanie do API wygasa.

  • Rozwiązanie: Zwiększ limit czasu w swoim kliencie HTTP. Sprawdź stabilność swojego połączenia sieciowego.

• Błąd SSL/TLS: Problemy z certyfikatami HTTPS.

  • Rozwiązanie: Upewnij się, że Twoje środowisko ma aktualne certyfikaty główne. Sprawdź, czy nie ma problemów z serwerem proxy lub zaporą sieciową, które mogą przechwytywać ruch SSL.

6. Błędy przetwarzania

• 500 Internal Server Error: Ogólny błąd po stronie serwera.

  • Rozwiązanie: Wskazuje to na problem po naszej stronie. Spróbuj ponownie wysłać żądanie po pewnym czasie. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną, podając jobId i szczegóły żądania.

• 503 Service Unavailable: Usługa jest tymczasowo niedostępna.

  • Rozwiązanie: Może to być spowodowane konserwacją lub dużym obciążeniem. Spróbuj ponownie wysłać żądanie po pewnym czasie.

7. Problemy z wydajnością

• Wolne przetwarzanie: Żądania trwają dłużej niż oczekiwano.
  • Rozwiązanie:
    1. Rozmiar obrazu: Większe obrazy wymagają więcej czasu na przetworzenie. Zoptymalizuj rozmiar obrazu.
    2. Złożoność operacji: Złożone operacje edycji (np. przenoszenie stylu) trwają dłużej.
    3. Region: Upewnij się, że używasz regionu najbliższego Twoim użytkownikom lub serwerom.
    4. Przetwarzanie wsadowe: W przypadku wielu operacji rozważ przetwarzanie wsadowe, jeśli ma to zastosowanie.

8. Narzędzia do debugowania

• Dzienniki API: Sprawdź dzienniki żądań w konsoli Qwen Image Edit, aby uzyskać szczegółowe informacje o błędach.
• Narzędzia deweloperskie przeglądarki: Użyj zakładki „Sieć” w narzędziach deweloperskich przeglądarki, aby sprawdzić żądania i odpowiedzi API.
• Narzędzia wiersza poleceń: Użyj curl lub Postman do bezpośredniego testowania żądań API i izolowania problemów.