Hướng dẫn khắc phục sự cố Qwen Image Edit

Hướng dẫn này được thiết kế để giúp bạn khắc phục các sự cố thường gặp mà bạn có thể gặp phải khi sử dụng API Qwen Image Edit. Làm theo các bước trong mỗi phần để nhanh chóng chẩn đoán và giải quyết vấn đề.

1. Các vấn đề chung

Nếu bạn gặp sự cố với các lệnh gọi API của mình, trước tiên hãy kiểm tra những điều sau:

• Khóa API: Đảm bảo khóa API của bạn chính xác và hợp lệ.
• Khu vực: Đảm bảo khu vực mà client của bạn được cấu hình là chính xác và khớp với khóa API của bạn.
• Kết nối Internet: Đảm bảo ứng dụng của bạn có kết nối internet đang hoạt động.
• Phiên bản SDK: Đảm bảo bạn đang sử dụng phiên bản SDK mới nhất. Các phiên bản cũ có thể gây ra sự cố tương thích.

2. Lỗi xác thực

2.1. 401 Unauthorized

Lỗi này thường xảy ra do khóa API không hợp lệ hoặc bị thiếu.

• Giải pháp: Đảm bảo bạn đang truyền khóa API chính xác trong tiêu đề Authorization ở định dạng Bearer YOUR_API_KEY. Kiểm tra xem khóa của bạn có bị hết hạn hoặc bị thu hồi không.

2.2. 403 Forbidden

Lỗi này cho biết khóa API của bạn không có các quyền cần thiết để thực hiện thao tác được yêu cầu.

• Giải pháp: Kiểm tra các quyền được liên kết với khóa API của bạn trong bảng điều khiển Qwen Image Edit. Cập nhật các quyền nếu cần.

3. Vấn đề về hạn ngạch và giới hạn tốc độ

3.1. 429 Too Many Requests

Lỗi này xảy ra khi bạn vượt quá giới hạn tốc độ API.

• Giải pháp: Giảm tần suất các lệnh gọi API của bạn bằng cách thêm độ trễ giữa các yêu cầu hoặc triển khai chiến lược thử lại với thời gian chờ tăng dần. Bạn có thể cân nhắc liên hệ với bộ phận hỗ trợ Qwen Image Edit để có giới hạn tốc độ cao hơn.

3.2. 402 Payment Required

Lỗi này cho biết bạn đã vượt quá hạn ngạch sử dụng hoặc tài khoản của bạn không có đủ tín dụng.

• Giải pháp: Kiểm tra việc sử dụng và thông tin thanh toán của bạn trong bảng điều khiển Qwen Image Edit. Nạp thêm tín dụng vào tài khoản của bạn hoặc nâng cấp gói của bạn nếu cần.

4. Vấn đề liên quan đến hình ảnh

4.1. Invalid Image URL hoặc Image Not Found

Những lỗi này xảy ra khi URL hình ảnh được truyền đến API không hợp lệ hoặc không thể truy cập được.

• Giải pháp: Đảm bảo URL hình ảnh được nhập chính xác, có thể truy cập công khai và không bị chặn bởi tường lửa hoặc yêu cầu xác thực.

4.2. Unsupported Image Format

Lỗi này xảy ra khi sử dụng định dạng hình ảnh không được API hỗ trợ.

• Giải pháp: Đảm bảo hình ảnh của bạn ở định dạng được hỗ trợ như JPEG, PNG hoặc WebP. Chuyển đổi hình ảnh nếu cần.

4.3. Image Too Large

Lỗi này xảy ra khi gửi hình ảnh có kích thước lớn hơn mức API cho phép.

• Giải pháp: Nén hoặc thay đổi kích thước hình ảnh để phù hợp với kích thước tối đa được API cho phép (thường là 10MB).

5. Vấn đề mạng

5.1. Hết thời gian chờ kết nối

Xảy ra khi ứng dụng của bạn không thể kết nối với máy chủ API hoặc phản hồi mất quá nhiều thời gian.

• Giải pháp: Kiểm tra kết nối internet của bạn. Thử tăng cài đặt thời gian chờ trong cấu hình client của bạn. Kiểm tra trang trạng thái dịch vụ Qwen Image Edit để biết bất kỳ sự cố ngừng hoạt động nào.

6. Lỗi xử lý

6.1. Processing Failed hoặc Internal Server Error (500)

Những lỗi này cho biết API gặp sự cố nội bộ khi xử lý yêu cầu của bạn.

• Giải pháp: Đảm bảo yêu cầu của bạn hợp lệ và tất cả các tham số đều chính xác. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ Qwen Image Edit với thông tin chi tiết về yêu cầu của bạn.

6.2. Invalid Prompt

Cho biết lời nhắc được cung cấp không thể được API hiểu hoặc xử lý.

• Giải pháp: Đảm bảo lời nhắc của bạn rõ ràng, súc tích và tương thích với khả năng của API. Thử nghiệm với các lời nhắc đơn giản hơn hoặc làm theo các định dạng lời nhắc trong các ví dụ.

7. Vấn đề hiệu suất

7.1. Thời gian phản hồi chậm

Nếu bạn nhận thấy các phản hồi API mất nhiều thời gian hơn dự kiến.

• Giải pháp: Cân nhắc sử dụng hình ảnh nhỏ hơn hoặc tối ưu hóa kích thước hình ảnh. Nếu bạn đang sử dụng xử lý hàng loạt, hãy thử giảm kích thước yêu cầu. Chọn một khu vực API gần hơn về mặt địa lý để giảm độ trễ mạng.

8. Công cụ gỡ lỗi

• Kiểm tra phản hồi API: Luôn ghi lại và kiểm tra phản hồi đầy đủ từ API, bao gồm mã trạng thái và thông báo lỗi.
• Ghi nhật ký SDK: Bật tính năng ghi nhật ký của SDK của bạn (xem phần cấu hình) và kiểm tra nhật ký để biết thông tin gỡ lỗi chi tiết hơn.
• Bảng điều khiển Qwen Image Edit: Kiểm tra lịch sử công việc, việc sử dụng API và nhật ký lỗi trong bảng điều khiển.