การกำหนดค่า

ส่วนนี้อธิบายวิธีการกำหนดค่า Qwen Image Edit สำหรับโครงการของคุณ

การกำหนดค่าเริ่มต้น

ในการเริ่มต้น คุณต้องกำหนดค่าไคลเอนต์ด้วย API Key และภูมิภาคของคุณ

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

const qwen = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  region: 'us-east-1', // หรือภูมิภาคที่คุณต้องการ
});

ตัวแปรสภาพแวดล้อม

ขอแนะนำให้ใช้ตัวแปรสภาพแวดล้อมเพื่อจัดเก็บ API Key และข้อมูลที่ละเอียดอ่อนอื่นๆ

# .env.local
QWEN_API_KEY=your_api_key

การกำหนดค่าขั้นสูง

การตั้งค่าไคลเอนต์

คุณสามารถปรับแต่งไคลเอนต์ด้วยตัวเลือกเพิ่มเติม เช่น timeout และ retries

const qwen = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  timeout: 30000, // 30 วินาที
  maxRetries: 5,
});

แคช

กำหนดค่าตัวเลือกการแคชเพื่อปรับปรุงประสิทธิภาพ

const qwen = new QwenImageEdit({
  // ...
  cache: {
    enabled: true,
    ttl: 3600, // 1 ชั่วโมง
  },
});

พร็อกซี

หากจำเป็น ให้กำหนดค่าพร็อกซีสำหรับการเรียก API

const qwen = new QwenImageEdit({
  // ...
  proxy: 'http://your_proxy:8080',
});

การกำหนดค่าเฉพาะสภาพแวดล้อม

คุณสามารถมีการกำหนดค่าที่แตกต่างกันสำหรับสภาพแวดล้อมการพัฒนา, staging และ production

const config = {
  development: {
    // ...
  },
  production: {
    // ...
  },
};

const qwen = new QwenImageEdit(config[process.env.NODE_ENV]);

การบันทึก (Logging)

เปิดใช้งานและกำหนดค่าการบันทึกสำหรับการดีบักและการตรวจสอบ

const qwen = new QwenImageEdit({
  // ...
  logging: {
    level: 'debug', // 'info', 'warn', 'error'
    // ...
  },
});

ความปลอดภัย

ใช้แนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัยเพื่อปกป้อง API Key และข้อมูลของคุณ

• ห้ามเปิดเผย API Key ในฝั่งไคลเอนต์โดยเด็ดขาด
• ใช้การเชื่อมต่อ HTTPS
• หมุนเวียน API Key เป็นประจำ

ประสิทธิภาพ

ปรับปรุงประสิทธิภาพโดยการกำหนดค่าไคลเอนต์อย่างมีประสิทธิภาพ

• ใช้การแคชสำหรับการตอบกลับ API
• ใช้การจัดการข้อผิดพลาดด้วยการลองใหม่และ exponential backoff

การตรวจสอบ

รวมเครื่องมือตรวจสอบเพื่อติดตามการใช้งาน API และประสิทธิภาพ

เครื่องมือสำหรับนักพัฒนา

ใช้เครื่องมือสำหรับนักพัฒนาเพื่ออำนวยความสะดวกในการรวมและการดีบัก

• SDK สำหรับภาษาต่างๆ
• เอกสาร API แบบโต้ตอบ

แนวทางปฏิบัติที่ดีที่สุด

• การจัดการข้อผิดพลาด: ใช้การจัดการข้อผิดพลาดที่แข็งแกร่งสำหรับการเรียก API ทั้งหมด
• การลองใหม่: ใช้ตรรกะการลองใหม่ด้วย exponential backoff สำหรับข้อผิดพลาดชั่วคราว
• Idempotency: ออกแบบการเรียก API ของคุณให้เป็น idempotent เมื่อเป็นไปได้