Panduan Permulaan Pantas (Bahasa Melayu)

Panduan ini akan membantu anda memulakan penggunaan QwenImageEdit SDK dengan cepat. Anda akan belajar cara memasang SDK, mendapatkan kunci API anda, memulakan SDK, dan melakukan operasi pertama anda.

1. Pemasangan SDK

Pasang QwenImageEdit SDK menggunakan npm atau yarn:

npm install @qwen-image-edit/sdk
# atau
yarn add @qwen-image-edit/sdk

2. Mendapatkan Kunci API Anda

Untuk menggunakan QwenImageEdit SDK, anda memerlukan kunci API. Ikuti langkah-langkah ini untuk mendapatkannya:

1. Log masuk ke akaun QwenImageEdit anda.
2. Navigasi ke bahagian "Tetapan API" atau "Kunci API".
3. Hasilkan kunci API baharu jika anda belum memilikinya.
4. Simpan kunci API anda dengan selamat. Anda akan memerlukannya untuk memulakan SDK.

3. Memulakan SDK

Setelah anda memasang SDK dan mendapatkan kunci API anda, anda boleh memulakan SDK dalam aplikasi anda:

import { QwenImageEdit } from '@qwen-image-edit/sdk';

const qwenImageEdit = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY, // Gunakan pemboleh ubah persekitaran
  // Anda juga boleh menentukan wilayah (region) jika diperlukan, cth., region: 'us-east-1'
});

console.log('QwenImageEdit SDK berjaya dimulakan.');

4. Operasi Pertama Anda: Menghilangkan Latar Belakang

Mari kita lakukan operasi penyuntingan imej pertama anda: menghilangkan latar belakang dari imej. Ini adalah salah satu ciri yang paling biasa digunakan dalam QwenImageEdit.

import { QwenImageEdit } from '@qwen-image-edit/sdk';

const qwenImageEdit = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
});

async function removeImageBackground() {
  try {
    const imageUrl = 'https://example.com/your-image-with-background.jpg'; // Gantikan dengan URL imej anda
    const result = await qwenImageEdit.image.removeBackground({
      image: imageUrl,
      outputFormat: 'png', // PNG menyokong ketelusan
    });

    console.log('Latar belakang berjaya dihilangkan. URL imej baharu:', result.imageUrl);
    // Anda kini boleh menggunakan result.imageUrl untuk memaparkan atau menyimpan imej yang telah diproses
  } catch (error) {
    console.error('Ralat semasa menghilangkan latar belakang:', error);
  }
}

removeImageBackground();

Apa Seterusnya?

Anda kini telah berjaya memasang, memulakan, dan menggunakan QwenImageEdit SDK untuk operasi pertama anda. Terokai dokumentasi lain untuk mengetahui lebih lanjut tentang ciri-ciri canggih seperti:

• Penyuntingan Teks: Mengubah, menterjemah, atau membetulkan teks dalam imej.
• Penambahan Elemen: Menambah logo, watermark, atau label harga.
• Pemindahan Gaya: Mengaplikasikan gaya artistik atau fotografi.
• Pemprosesan Batch: Mengendalikan berbilang imej sekaligus.
• API Lanjutan: Menggunakan fungsi API yang lebih spesifik untuk kawalan yang lebih halus.

Selamat menyunting imej dengan QwenImageEdit!