การแก้ไขปัญหา

ส่วนนี้ให้แนวทางแก้ไขปัญหาทั่วไปที่คุณอาจพบเมื่อใช้ Qwen Image Edit

ปัญหาทั่วไป

ข้อผิดพลาดในการยืนยันตัวตน

• API Key ไม่ถูกต้อง: ตรวจสอบให้แน่ใจว่า apiKey ของคุณถูกต้องและใช้งานได้ ตรวจสอบว่าไม่มีช่องว่างพิเศษหรืออักขระที่ไม่ถูกต้อง
• API Key หมดอายุ: ตรวจสอบวันหมดอายุของ API Key ในแผงควบคุมของคุณ สร้างใหม่หากจำเป็น
• สิทธิ์ไม่เพียงพอ: ตรวจสอบให้แน่ใจว่า API Key ของคุณมีสิทธิ์ที่จำเป็นสำหรับการดำเนินการที่คุณพยายามทำ

ปัญหาโควต้าและอัตราการจำกัด

• เกินขีดจำกัดอัตรา (429 Too Many Requests): คุณได้ส่งคำขอเกินจำนวนที่อนุญาตในช่วงเวลาที่กำหนด ใช้กลไก exponential backoff เพื่อลองส่งคำขอใหม่
• โควต้าหมด: คุณได้ใช้โควต้าการใช้งานของคุณหมดแล้ว ตรวจสอบการใช้งานของคุณในแผงควบคุมและพิจารณาอัปเกรดแผนของคุณ

ปัญหาเกี่ยวกับรูปภาพ

• รูปแบบรูปภาพไม่รองรับ: ตรวจสอบให้แน่ใจว่ารูปภาพอยู่ในรูปแบบที่รองรับ (เช่น JPEG, PNG) ดูเอกสารประกอบสำหรับรายการทั้งหมด
• รูปภาพใหญ่เกินไป: รูปภาพที่เกินขนาดสูงสุดหรือความละเอียดที่อนุญาตจะถูกปฏิเสธ ปรับขนาดรูปภาพก่อนอัปโหลด
• รูปภาพเสียหาย: รูปภาพอาจเสียหาย ลองใช้รูปภาพอื่นหรือสร้างรูปภาพปัจจุบันใหม่

ปัญหาเครือข่าย

• หมดเวลาการเชื่อมต่อ: คำขอ API ใช้เวลานานเกินไปในการดำเนินการ ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตของคุณแล้วลองอีกครั้ง คุณอาจต้องเพิ่ม timeout ใน SDK client ของคุณ
• ปัญหา DNS: ตรวจสอบให้แน่ใจว่าระบบของคุณสามารถแก้ไขชื่อโดเมนของ Qwen Image Edit ได้อย่างถูกต้อง

ข้อผิดพลาดในการประมวลผล

• พารามิเตอร์ไม่ถูกต้อง: ตรวจสอบพารามิเตอร์คำขอ API ของคุณ ตรวจสอบให้แน่ใจว่าฟิลด์ที่จำเป็นทั้งหมดมีอยู่และค่าอยู่ในรูปแบบที่ถูกต้อง
• ข้อผิดพลาดภายในเซิร์ฟเวอร์ (500 Internal Server Error): นี่แสดงถึงปัญหาฝั่งเซิร์ฟเวอร์ หากปัญหายังคงอยู่ โปรดติดต่อฝ่ายสนับสนุนด้านเทคนิคของ Qwen Image Edit พร้อมให้รายละเอียดคำขอของคุณและ ID ธุรกรรม (ถ้ามี)
• ไม่พบทรัพยากร (404 Not Found): ไม่พบจุดสิ้นสุด API หรือทรัพยากรที่ร้องขอ ตรวจสอบ URL ของจุดสิ้นสุด

ปัญหาประสิทธิภาพ

• ความหน่วงสูง: ความหน่วงอาจได้รับผลกระทบจากระยะทางทางภูมิศาสตร์จากเซิร์ฟเวอร์ API หรือโหลดของเซิร์ฟเวอร์ พิจารณาใช้ภูมิภาค API ที่ใกล้กว่าหากมี
• การประมวลผลช้า: รูปภาพขนาดใหญ่หรือการดำเนินการที่ซับซ้อนอาจใช้เวลานานขึ้น ปรับรูปภาพและคำขอของคุณให้เหมาะสมที่สุดเมื่อเป็นไปได้

เครื่องมือดีบัก

• บันทึกเซิร์ฟเวอร์: ตรวจสอบบันทึกแอปพลิเคชันของคุณสำหรับข้อความแสดงข้อผิดพลาดหรือคำเตือนที่เกี่ยวข้องกับการเรียก API
• ID คำขอ: การตอบกลับ API แต่ละรายการมี ID คำขอ ระบุ ID นี้ให้ฝ่ายสนับสนุนด้านเทคนิคเพื่อช่วยในการวินิจฉัยปัญหา
• เครื่องมือเครือข่ายของเบราว์เซอร์: ใช้เครื่องมือสำหรับนักพัฒนาของเบราว์เซอร์ (แท็บเครือข่าย) เพื่อตรวจสอบคำขอและการตอบกลับ API