Konfigurasi

Dokumen ini menyediakan panduan komprehensif untuk mengkonfigurasi Qwen Image Edit, meliputi persediaan awal dan konfigurasi lanjutan.

Persediaan Awal

Pemboleh Ubah Persekitaran

Konfigurasi pemboleh ubah persekitaran penting untuk memastikan Qwen Image Edit berfungsi dengan betul. Pemboleh ubah ini biasanya termasuk kunci API, tetapan wilayah, dan maklumat sensitif lain.

# .env.local
QWEN_IMAGE_EDIT_API_KEY=kunci_api_anda
QWEN_IMAGE_EDIT_REGION=wilayah_anda

Persediaan Klien

Inisialisasi klien Qwen Image Edit dalam aplikasi anda. Ini melibatkan pengimportan SDK yang diperlukan dan mengkonfigurasinya dengan kunci API dan wilayah anda.

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

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

# Python
from qwen_image_edit_sdk import QwenImageEdit

client = QwenImageEdit(
    api_key=os.environ.get("QWEN_IMAGE_EDIT_API_KEY"),
    region=os.environ.get("QWEN_IMAGE_EDIT_REGION")
)

Konfigurasi Lanjutan

Konfigurasi Cache

Optimumkan prestasi dengan mengkonfigurasi mekanisme caching. Anda boleh menentukan tempoh cache, saiz, dan lokasi penyimpanan.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  cache: {
    enabled: true,
    ttl: 3600, // saat
    maxEntries: 100,
  },
});

Tetapan Proksi

Jika aplikasi anda beroperasi di belakang proksi, konfigurasi tetapan proksi untuk klien Qwen Image Edit.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  proxy: {
    host: 'http://proksi.anda.com',
    port: 8080,
  },
});

Konfigurasi Spesifik Persekitaran

Urus konfigurasi yang berbeza untuk pelbagai persekitaran (pembangunan, pementasan, pengeluaran) menggunakan pemboleh ubah persekitaran atau fail konfigurasi.

// config/development.js
export const config = {
  apiEndpoint: 'https://dev.api.qwen-image-edit.com',
  logLevel: 'debug',
};

// config/production.js
export const config = {
  apiEndpoint: 'https://api.qwen-image-edit.com',
  logLevel: 'info',
};

Pengelogan (Logging)

Konfigurasi tahap pengelogan dan destinasi untuk memantau permintaan dan respons API, serta membantu dalam penyahpepijatan.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  logging: {
    level: 'info', // 'debug', 'info', 'warn', 'error'
    destination: 'console', // 'console', 'file', 'custom'
  },
});

Konfigurasi Keselamatan

Laksanakan amalan terbaik keselamatan, seperti pembatasan kadar, penyenaraian putih IP, dan pengurusan kelayakan yang selamat.

Penalaan Prestasi

Laraskan parameter berkaitan konkurensi, tamat masa, dan pemprosesan kelompok untuk mengoptimumkan prestasi untuk kes penggunaan spesifik anda.

Pemantauan dan Makluman

Integrasikan dengan alat pemantauan untuk menjejaki penggunaan API, metrik prestasi, dan menyediakan makluman untuk anomali.

Alat Pembangunan

Gunakan konfigurasi khusus pembangunan untuk ciri seperti hot-reloading, alat penyahpepijatan, dan pelayan olok-olok.

Amalan Terbaik

• Kunci API Selamat: Jangan sekali-kali mengekod kunci API dalam pangkalan kod anda. Gunakan pemboleh ubah persekitaran atau perkhidmatan pengurusan rahsia yang selamat.
• Pengendalian Ralat: Laksanakan mekanisme pengendalian ralat dan cuba semula yang teguh untuk panggilan API.
• Idempotensi: Reka bentuk permintaan anda agar idempoten jika boleh untuk mengelakkan kesan sampingan yang tidak diingini daripada cuba semula.
• Pengurusan Sumber: Urus sumber imej dan sambungan dengan cekap untuk mengelakkan kebocoran.
• Kawalan Versi: Simpan fail konfigurasi anda di bawah kawalan versi dan urus perubahan dengan berhati-hati.

Dengan mengikuti panduan konfigurasi ini, anda boleh memastikan integrasi yang stabil, selamat, dan berprestasi tinggi dengan Qwen Image Edit.