Pemecahan Masalah Qwen Image Edit

Dokumen ini menyediakan panduan untuk memecahkan masalah umum yang mungkin Anda temui saat menggunakan Qwen Image Edit API atau SDK. Jika Anda tidak menemukan solusi di sini, silakan hubungi tim dukungan kami.

Masalah Umum

1. Gambar Tidak Diproses atau Diedit

• Penyebab: URL gambar tidak valid, gambar tidak dapat diakses, atau format gambar tidak didukung.
• Solusi:
  • Verifikasi bahwa URL gambar benar dan dapat diakses secara publik.
  • Pastikan gambar dalam format yang didukung (misalnya, JPEG, PNG, WebP).
  • Periksa log aplikasi Anda untuk pesan kesalahan terkait.

2. Kualitas Gambar Output Buruk

• Penyebab: Resolusi gambar input rendah, atau parameter kualitas output tidak diatur dengan benar.
• Solusi:
  • Gunakan gambar input dengan resolusi yang lebih tinggi.
  • Sesuaikan parameter quality dalam permintaan API Anda (jika tersedia).

3. Respons API Lambat

• Penyebab: Jaringan lambat, ukuran gambar besar, atau beban server tinggi.
• Solusi:
  • Optimalkan ukuran gambar input.
  • Pertimbangkan untuk menggunakan mekanisme caching untuk gambar yang sering diakses.
  • Periksa status sistem Qwen Image Edit untuk masalah kinerja yang diketahui.

Kesalahan Otentikasi

1. 401 Unauthorized

• Penyebab: Kunci API hilang atau tidak valid.
• Solusi:
  • Pastikan Anda menyertakan header Authorization: Bearer YOUR_API_KEY dalam permintaan Anda.
  • Verifikasi bahwa YOUR_API_KEY Anda benar dan aktif.

2. 403 Forbidden

• Penyebab: Kunci API tidak memiliki izin yang diperlukan untuk operasi yang diminta.
• Solusi:
  • Periksa izin yang terkait dengan Kunci API Anda di dasbor Qwen Image Edit.
  • Pastikan Anda menggunakan Kunci API yang benar untuk lingkungan (misalnya, pengembangan vs. produksi).

Masalah Kuota dan Batas Laju

1. 429 Too Many Requests

• Penyebab: Anda telah melampaui batas laju atau kuota penggunaan API Anda.
• Solusi:
  • Terapkan strategi percobaan ulang eksponensial dalam aplikasi Anda.
  • Tingkatkan kuota Anda melalui dasbor Qwen Image Edit atau hubungi dukungan.
  • Optimalkan panggilan API Anda untuk mengurangi jumlah permintaan.

Masalah Terkait Gambar

1. Gambar Rusak atau Tidak Lengkap

• Penyebab: Masalah transfer data atau korupsi file.
• Solusi:
  • Coba unggah ulang gambar.
  • Verifikasi integritas file gambar asli.

2. Warna atau Resolusi Tidak Akurat

• Penyebab: Profil warna yang tidak cocok atau masalah kompresi.
• Solusi:
  • Pastikan gambar input memiliki profil warna standar (misalnya, sRGB).
  • Hindari kompresi berlebihan pada gambar input.

Masalah Jaringan

1. Timeout Koneksi

• Penyebab: Masalah jaringan antara aplikasi Anda dan server Qwen Image Edit.
• Solusi:
  • Periksa konektivitas jaringan Anda.
  • Tingkatkan nilai timeout dalam konfigurasi klien HTTP Anda.

2. Kesalahan SSL/TLS

• Penyebab: Sertifikat SSL tidak valid atau konfigurasi TLS yang salah.
• Solusi:
  • Pastikan sistem Anda memiliki sertifikat root terbaru.
  • Verifikasi bahwa URL API menggunakan HTTPS yang benar.

Kegagalan Pemrosesan

1. Kesalahan Internal Server (500)

• Penyebab: Masalah tak terduga di sisi server Qwen Image Edit.
• Solusi:
  • Coba lagi permintaan setelah beberapa saat.
  • Periksa halaman status Qwen Image Edit untuk pemadaman yang diketahui.
  • Hubungi dukungan dengan job_id dan detail permintaan Anda.

2. Kesalahan Validasi Prompt

• Penyebab: Prompt yang diberikan tidak jelas, ambigu, atau tidak dapat diproses oleh AI.
• Solusi:
  • Buat prompt Anda lebih spesifik dan jelas.
  • Hindari instruksi yang kontradiktif.
  • Lihat panduan prompt kami untuk praktik terbaik.

Masalah Kinerja

1. Penggunaan Memori Tinggi

• Penyebab: Memproses gambar beresolusi sangat tinggi atau sejumlah besar gambar secara bersamaan.
• Solusi:
  • Optimalkan ukuran gambar sebelum mengirim ke API.
  • Proses gambar dalam batch yang lebih kecil.

2. Latensi Tinggi

• Penyebab: Jarak geografis ke server API, atau beban server.
• Solusi:
  • Pilih wilayah API yang paling dekat dengan pengguna Anda.
  • Manfaatkan Webhook untuk pemrosesan asinkron.

Alat Debugging

• Log Aplikasi: Periksa log aplikasi Anda untuk pesan kesalahan atau peringatan dari SDK Qwen Image Edit.
• Dasbor Qwen Image Edit: Gunakan dasbor untuk melihat riwayat panggilan API, penggunaan kuota, dan status pekerjaan.
• Alat Jaringan: Gunakan alat seperti curl, Postman, atau tab jaringan browser Anda untuk memeriksa permintaan dan respons API.
• Mode Debug SDK: Aktifkan mode debug di SDK untuk mendapatkan informasi yang lebih rinci tentang panggilan API.