Skip to Content

Ảnh

Hai công cụ list_images và upload_image để agent dùng ảnh thật của bạn trên website của app, từ ảnh bạn đã tải lên hoặc từ link và file bạn gửi trong cuộc trò chuyện.

Website của một tiệm spa trông thật hơn hẳn khi có ảnh phòng, đội ngũ và dịch vụ của chính tiệm. Agent dùng ảnh của bạn trước, ảnh mẫu chỉ để giữ chỗ.

list_images

Liệt kê ảnh bạn đã tải lên cho app, trong thư mục public/ của kho file.

  • Tham số: project; folder: thư mục con trong public/, ví dụ gallery. Mặc định lấy cả public/.
  • Trả về: images, tối đa 200 ảnh, mỗi ảnh có src, name và cỡ (KB); total.
  • Khi nào gọi: trước khi làm trang chủ, thư viện ảnh, trang giới thiệu.

src có dạng /_files/public/<tên>, thêm #w=480,800,… khi có bản thu nhỏ cho điện thoại. Agent đặt nguyên src vào <Img src> hoặc <img src>; Img của bộ giao diện website đổi phần #w= thành srcset. Agent không nhìn thấy ảnh, nên chỉ mô tả ảnh theo tên file hoặc theo lời bạn.

upload_image

Lưu một ảnh bạn đưa (link https công khai, hoặc file bạn đính kèm trong cuộc trò chuyện) vào public/ của kho file, kèm các bản thu nhỏ cho điện thoại.

  • Tham số:
    • project.
    • url: link https tới ảnh; hoặc file: file bạn đính kèm.
    • name: tên file muốn lưu, ví dụ hero-studio. Chữ có dấu được đổi sang không dấu.
    • folder: thư mục con trong public/, ví dụ gallery.
  • Trả về: src để dùng trên website, name, kích thước ảnh và các cỡ thu nhỏ.
  • Khi nào gọi: khi bạn gửi ảnh trong cuộc trò chuyện hoặc dán link ảnh.

Chỉ nhận ảnh jpg, png, webp, gif, avif hoặc heic, tối đa 20 MB. Ảnh trùng tên thì bị thay. Ảnh có ngay trên tên miền của app, không cần deploy. Agent chỉ lưu ảnh bạn đưa hoặc bạn yêu cầu, không chép ảnh từ website khác.

Bạn cũng tải ảnh lên trong dashboard, ở trang File của project.

Bước tiếp theo

Cập nhật