search

Xử Lý Sự Cố Thường Gặp

Tổng hợp các lỗi phổ biến khi sử dụng Visual Agents và cách khắc phục nhanh chóng.

Vấn Đề Upload Ảnh

warning
Ảnh không upload được
  • Kiểm tra định dạng: Chỉ hỗ trợ PNG, JPG, JPEG, WebP
  • Kiểm tra dung lượng: Tối đa 20MB mỗi ảnh
  • Kiểm tra kết nối: Đảm bảo Internet ổn định, upload qua WiFi thay vì 4G nếu file lớn
  • Đổi tên file: Tránh ký tự đặc biệt trong tên file (dấu cách, dấu tiếng Việt)

Upload chậm

  • Nén ảnh trước khi upload nếu ảnh >10MB
  • Sử dụng kết nối WiFi ổn định
  • Đóng các tab/ứng dụng đang tải dữ liệu lớn

Vấn Đề Kết Quả Render

warning
Ảnh render bị mờ, không sắc nét
  • Ảnh gốc độ phân giải thấp: Tối thiểu 1920x1080 cho viewport đầu vào
  • Chọn độ phân giải đầu ra cao hơn: Thử 2K hoặc 4K
  • Ảnh gốc bị nhiễu nén JPG: Xuất viewport dạng PNG thay vì JPG
warning
Kết quả khác xa mong đợi
  • Prompt quá ngắn: Viết mô tả chi tiết hơn về phong cách, vật liệu, ánh sáng
  • Chọn sai agent: Xem lại bảng so sánh agent
  • Style không phù hợp: Chọn style có bối cảnh tương đồng với ảnh gốc
  • Render lại: Điều chỉnh prompt/style và thử lại (không mất thêm credit nếu trong 30 giây)

Render thất bại / Lỗi Server

  • Kiểm tra credit còn không (Dashboard → Credits)
  • Thử render lại sau 1-2 phút
  • Kiểm tra kích thước ảnh đầu vào (tối đa 4096px mỗi chiều)
  • Liên hệ hỗ trợ qua chatbot AI ở góc dưới bên phải

Quick Fixes

Không đăng nhập được

  • Kiểm tra email đã đăng ký chính xác
  • Dùng "Quên mật khẩu" để reset
  • Kiểm tra hộp thư spam cho email xác nhận
  • Thử đăng nhập bằng Google nếu đã liên kết

Credit bị trừ nhiều hơn dự kiến

  • Kiểm tra lịch sử render (Dashboard → Lịch sử)
  • Ảnh 4K tiêu tốn 2 credit thay vì 1 (với một số agent)
  • Render đồng thời tính từng credit riêng

Vấn Đề API & Tích Hợp

warning
API trả về lỗi 401 Unauthorized
  • Kiểm tra API Key trong Cài đặt → API Keys
  • Đảm bảo header Authorization: Bearer YOUR_API_KEY chính xác
  • API Key có thể đã hết hạn → tạo key mới

Webhook không nhận được callback

  • Kiểm tra webhook URL khả dụng từ bên ngoài (dùng ngrok để test local)
  • Đảm bảo server của bạn xử lý POST request
  • Kiểm tra log webhook trong Dashboard

Vấn Đề Hiển Thị / Giao Diện

Trang web chạy chậm

  • Xóa cache trình duyệt
  • Dùng trình duyệt Chrome/Firefox phiên bản mới nhất
  • Tắt các extension không cần thiết

Ảnh render không hiển thị

  • Thử refresh trang (F5)
  • Kiểm tra ảnh đã hoàn tất render (trạng thái "Completed")
  • Ảnh quá cũ có thể đã bị xóa khỏi CDN → render lại
info
Vẫn gặp vấn đề?

Sử dụng trợ lý AI ở góc dưới bên phải màn hình để được hỗ trợ trực tiếp. Đội ngũ hỗ trợ cũng có thể liên hệ qua email support@agents.clik.id.

boltTrải nghiệm ngay