Penyelesaian Masalah (Bahasa Melayu)

Dokumen ini menyediakan panduan penyelesaian masalah untuk isu-isu biasa yang mungkin anda hadapi semasa menggunakan QwenImageEdit SDK. Jika anda tidak menemui penyelesaian di sini, sila rujuk dokumentasi API atau hubungi sokongan.

1. Ralat Pengesahan (Authentication Errors)

Isu: `Invalid API Key` atau `Unauthorized`

Penerangan: Ini berlaku apabila kunci API yang diberikan tidak sah, tamat tempoh, atau tidak mempunyai kebenaran yang mencukupi.

Penyelesaian:

Sahkan Kunci API: Pastikan anda menggunakan kunci API yang betul dan aktif dari papan pemuka QwenImageEdit anda.
Semak Kebenaran: Pastikan kunci API anda mempunyai kebenaran yang diperlukan untuk operasi yang anda cuba lakukan.
Pemboleh Ubah Persekitaran: Jika anda menggunakan pemboleh ubah persekitaran, pastikan ia dimuatkan dengan betul dan tidak ada kesilapan menaip.

// Pastikan kunci API anda dimuatkan dengan betul
const qwenImageEdit = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY, // Semak nilai ini
});

Isu: `Rate Limit Exceeded`

Penerangan: Anda telah melebihi had panggilan API yang dibenarkan dalam tempoh masa tertentu.

Penyelesaian:

Tunggu: Had kadar biasanya ditetapkan semula selepas tempoh tertentu (cth., seminit atau sejam). Tunggu sebentar sebelum mencuba lagi.
Strategi Cuba Semula (Retry Strategy): Laksanakan logik cuba semula dengan backoff eksponen dalam kod anda untuk mengendalikan had kadar secara automatik.
Tingkatkan Had Kadar: Jika anda memerlukan had yang lebih tinggi, hubungi sokongan QwenImageEdit untuk membincangkan pilihan pelan anda.

// Contoh logik cuba semula asas
async function callApiWithRetry(apiCall, retries = 3, delay = 1000) {
  try {
    return await apiCall();
  } catch (error) {
    if (error.statusCode === 429 && retries > 0) { // 429 Too Many Requests
      console.warn(`Had kadar dicapai, mencuba semula dalam ${delay / 1000} saat...`);
      await new Promise(res => setTimeout(res, delay));
      return callApiWithRetry(apiCall, retries - 1, delay * 2);
    } else {
      throw error;
    }
  }
}

// Cara menggunakannya:
// callApiWithRetry(() => qwenImageEdit.image.removeBackground(...));

2. Isu Rangkaian dan Masa Tamat (Network and Timeout Issues)

Isu: `Network Error` atau `Timeout`

Penerangan: Ini menunjukkan masalah sambungan rangkaian atau API tidak bertindak balas dalam masa yang ditetapkan.

Penyelesaian:

Semak Sambungan Internet: Pastikan aplikasi anda mempunyai sambungan internet yang stabil.
Tingkatkan Masa Tamat: Konfigurasi SDK untuk mempunyai masa tamat yang lebih lama, terutamanya untuk operasi imej yang besar atau kompleks.
Cuba Semula: Laksanakan logik cuba semula untuk ralat rangkaian sementara.
Status Perkhidmatan: Semak halaman status QwenImageEdit untuk sebarang isu perkhidmatan yang diketahui.

const qwenImageEdit = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  timeout: 30000, // Tetapkan masa tamat kepada 30 saat (dalam milisaat)
});

3. Kegagalan Pemprosesan Imej (Image Processing Failures)

Isu: `Image not found` atau `Invalid image URL`

Penerangan: URL imej yang diberikan tidak dapat diakses atau tidak menunjuk kepada fail imej yang sah.

Penyelesaian:

Sahkan URL: Pastikan URL imej adalah betul dan boleh diakses secara awam.
Format Imej: Pastikan imej berada dalam format yang disokong (cth., JPG, PNG, WEBP).
Ketersediaan Pelayan: Jika imej dihoskan pada pelayan anda sendiri, pastikan pelayan itu berfungsi dan boleh diakses dari internet.

Isu: `Processing failed` atau `Unsupported image format`

Penerangan: API tidak dapat memproses imej kerana format yang tidak disokong, kerosakan, atau isu dalaman.

Penyelesaian:

Format Disokong: Rujuk dokumentasi QwenImageEdit untuk senarai format imej yang disokong.
Integriti Imej: Pastikan fail imej tidak rosak. Cuba buka imej secara manual untuk mengesahkan.
Saiz Imej: Imej yang sangat besar mungkin menghadapi masalah. Cuba kurangkan saiz imej jika boleh.
Hubungi Sokongan: Jika isu berterusan dengan imej yang sah, berikan URL imej dan ID permintaan kepada sokongan.

4. Hasil Tidak Dijangka atau Kualiti Rendah (Unexpected Results or Low Quality)

Isu: Hasil pengeditan tidak seperti yang dijangkakan atau kualiti rendah.

Penerangan: Output imej tidak memenuhi jangkaan anda dari segi kualiti atau ketepatan pengeditan.

Penyelesaian:

Perhalusi Prompt: Jika menggunakan ciri berasaskan AI (cth., pengeditan teks, pemindahan gaya), cuba perhalusi prompt anda agar lebih spesifik dan jelas.
Parameter: Semak parameter yang anda berikan kepada fungsi API (cth., outputFormat, quality, resolution). Sesuaikan mereka untuk hasil yang lebih baik.
Imej Sumber: Kualiti imej sumber sangat mempengaruhi hasil. Gunakan imej sumber berkualiti tinggi jika boleh.
Contoh: Rujuk bahagian contoh dalam dokumentasi untuk melihat cara operasi tertentu berfungsi.

5. Isu Caching (Caching Issues)

Isu: Perubahan tidak ditunjukkan atau imej lama dipaparkan.

Penerangan: Ini mungkin disebabkan oleh caching di pihak klien, CDN, atau dalam SDK itu sendiri.

Penyelesaian:

Kosongkan Cache Pelayar: Jika anda memaparkan imej dalam pelayar web, kosongkan cache pelayar anda.
CDN Cache: Jika anda menggunakan CDN, pastikan anda telah membersihkan cache CDN untuk URL imej yang berkaitan.
SDK Cache: Jika anda telah mengkonfigurasi caching dalam SDK, pastikan ia dikonfigurasi dengan betul atau cuba melumpuhkannya buat sementara waktu untuk tujuan penyahpepijatan.

6. Isu Pengelogan (Logging Issues)

Isu: Tidak melihat log atau log tidak mencukupi.

Penerangan: Anda tidak menerima maklumat pengelogan yang mencukupi untuk menyahpepijat isu.

Penyelesaian:

Tahap Log: Konfigurasi SDK untuk tahap pengelogan yang lebih terperinci (cth., debug atau verbose).
Integrasi Log: Pastikan sistem pengelogan aplikasi anda diintegrasikan dengan betul dengan output log SDK.

const qwenImageEdit = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  logLevel: 'debug', // Atau 'info', 'warn', 'error'
});

Jika anda masih menghadapi masalah, berikan maklumat berikut kepada pasukan sokongan QwenImageEdit:

ID Permintaan (jika ada)
Mesej ralat penuh dan kod status
Coretan kod yang menyebabkan isu
URL imej yang digunakan (jika berkaitan)
Langkah-langkah untuk menghasilkan semula isu

Penyelesaian Masalah

On this page