Risoluzione dei Problemi

Questa sezione fornisce soluzioni ai problemi comuni che potresti incontrare durante l'utilizzo di Qwen Image Edit.

Problemi Comuni

Errori di Autenticazione

• Chiave API non valida: Assicurati che la tua apiKey sia corretta e attiva. Controlla di non aver copiato spazi extra o caratteri errati.
• Chiave API scaduta: Verifica la data di scadenza della tua chiave API nel pannello di controllo. Generane una nuova se necessario.
• Permessi insufficienti: Assicurati che la tua chiave API abbia i permessi necessari per l'operazione che stai tentando di eseguire.

Problemi di Quota e Limiti di Frequenza

• Limite di frequenza superato (429 Too Many Requests): Hai superato il numero consentito di richieste in un dato periodo. Implementa un meccanismo di backoff esponenziale per riprovare le richieste.
• Quota esaurita: Hai consumato la tua quota di utilizzo. Controlla il tuo utilizzo nel pannello di controllo e considera l'aggiornamento del tuo piano.

Problemi Relativi all'Immagine

• Formato immagine non supportato: Assicurati che l'immagine sia in un formato supportato (es. JPEG, PNG). Consulta la documentazione per un elenco completo.
• Immagine troppo grande: Le immagini che superano le dimensioni o la risoluzione massime consentite verranno rifiutate. Ridimensiona l'immagine prima di caricarla.
• Immagine corrotta: L'immagine potrebbe essere danneggiata. Prova con un'altra immagine o ricrea quella corrente.

Problemi di Rete

• Timeout della connessione: La richiesta API ha impiegato troppo tempo per essere completata. Controlla la tua connessione internet e riprova. Potrebbe essere necessario aumentare il timeout nel tuo client SDK.
• Problemi DNS: Assicurati che il tuo sistema possa risolvere correttamente i nomi di dominio di Qwen Image Edit.

Errori di Elaborazione

• Parametri non validi: Controlla i parametri della tua richiesta API. Assicurati che tutti i campi obbligatori siano presenti e che i valori siano nel formato corretto.
• Errore interno del server (500 Internal Server Error): Questo indica un problema sul lato server. Se il problema persiste, contatta il supporto tecnico di Qwen Image Edit fornendo i dettagli della tua richiesta e l'ID della transazione (se disponibile).
• Risorsa non trovata (404 Not Found): L'endpoint API o la risorsa richiesta non esiste. Verifica l'URL dell'endpoint.

Problemi di Prestazioni

• Latenza elevata: La latenza può essere influenzata dalla distanza geografica dal server API o dal carico del server. Considera l'utilizzo di una regione API più vicina se disponibile.
• Elaborazione lenta: Immagini di grandi dimensioni o operazioni complesse possono richiedere più tempo. Ottimizza le tue immagini e le tue richieste quando possibile.

Strumenti di Debug

• Log del server: Controlla i log della tua applicazione per eventuali messaggi di errore o avvisi relativi alle chiamate API.
• ID della richiesta: Ogni risposta API include un ID di richiesta. Fornisci questo ID al supporto tecnico per aiutarli a diagnosticare il problema.
• Strumenti di rete del browser: Utilizza gli strumenti per sviluppatori del browser (scheda Rete) per ispezionare le richieste e le risposte API.