PerfectVector
Bởi Jay

Vector hóa ảnh trong Make qua HTTP và Google Drive

Gửi ảnh từ Google Drive đến API vector hóa bằng Make. Ánh xạ dữ liệu tệp, xử lý phản hồi chờ hoặc lỗi và lưu SVG ở thư mục khác.

8 phút đọc
Trên trang này

Dùng hướng dẫn này để ánh xạ tệp và các trường phản hồi trong kịch bản HTTP v4 của Make đọc ảnh raster từ Google Drive. Quy trình gồm gửi yêu cầu, lấy ID chuyển đổi và tải SVG. Phần trao đổi với API đã được xác minh bằng khóa thử nghiệm. Cách ánh xạ trong Make và Drive dựa trên tài liệu chính thức của các mô-đun.

Thử với hình ảnh của chính bạn
Mở công cụ đầy đủ
Dùng thử miễn phí. Thả ảnh vào để xem trước bản vector của bạn, không cần đăng ký.

Bắt đầu với một tệp và khóa thử nghiệm

Kết nối Google Drive với Make. Đặt một PNG, JPEG hoặc WebP một khung hình vào thư mục thử nghiệm, chọn một thư mục khác cho đầu ra và lấy khóa thử nghiệm PerfectVector. Chọn tệp không quá 5 MiB, mỗi cạnh từ 100 đến 4.096 pixel. Chuyển đổi thử nghiệm thành công trả về một SVG mẫu cố định. Chế độ thử nghiệm PerfectVector

Thêm Google Drive → Download a File và chọn tệp nguồn theo ID. Nếu sau này thêm trình kích hoạt theo thư mục, hãy ánh xạ ID từ trình kích hoạt sang mô-đun này. Lần đầu, dùng một tệp đã biết để kiểm tra tên và dữ liệu tệp trong đầu ra mô-đun. Hướng dẫn làm việc với tệp của Make

Ánh xạ tệp vào yêu cầu HTTP

Dùng HTTP → Make a request trong ứng dụng HTTP v4 của Make. Lưu khóa thử nghiệm trong Credentials với kiểu xác thực API key. Trong bộ thông tin xác thực, đặt toàn bộ giá trị bắt đầu bằng Bearer vào trường Key, chọn gửi trong phần đầu yêu cầu, đặt tên tham số là Authorization và giới hạn nguồn ở https://api.perfectvector.com. Dùng cùng bộ thông tin để tải xuống. Thiết lập khóa API của Make

Dùng https://api.perfectvector.com làm nguồn cho từng điểm cuối dưới đây.

Thiết lập HTTP v4Giá trị cho lần chạy đầu
URL và phương thứcPOST /v1/vectorizations
Kiểu nội dung phần thânmultipart/form-data
Trường trong phần thânKiểu File, tên image. Ánh xạ tên và dữ liệu tệp từ Download a File.
Phần đầu yêu cầuIdempotency-Key. Chọn giá trị ổn định riêng cho thao tác, chẳng hạn drive-logo-test-0001.
Phần đầu yêu cầuPrefer: wait=10
Parse responseYes. Chạy một lần để có các trường đầu ra dùng được như id và status.
Timeout30 giây cho yêu cầu này.

Make tạo dấu phân cách multipart khi bạn chọn kiểu nội dung. Giữ phản hồi POST ở dạng JSON để dùng cùng một định dạng dù chuyển đổi xong ngay hay cần chờ. Hai giây trong hướng dẫn của PerfectVector là khoảng cách giữa các lần kiểm tra trạng thái. Mô-đun HTTP của Make · Chờ và xử lý bất đồng bộ trong PerfectVector

Minh họa quy trình
Ảnh đi từ thư mục nguồn qua yêu cầu HTTP đến bản ghi chuyển đổi, rồi đến thư mục đích dưới dạng tệp vector.
Ánh xạ dữ liệu ảnh vào yêu cầu. Dùng ID chuyển đổi để kiểm tra trạng thái và lấy SVG cho thư mục đầu ra.

Chỉ tải xuống sau khi chuyển đổi thành công

Đặt bộ lọc trước HTTP → Download a file để chỉ chạy khi trạng thái đã phân tích là succeeded. Dùng cùng nguồn API và đường dẫn /v1/vectorizations/{id}/result. Thay {id} bằng ID chuyển đổi được ánh xạ. Dùng bộ thông tin xác thực API và đặt Return error if HTTP request fails thành Yes. Mô-đun tải xuống cung cấp dữ liệu tệp cho mô-đun tiếp theo. Mô-đun HTTP của Make · Kết quả PerfectVector

Thêm Google Drive → Upload a File và chọn thư mục đầu ra. Chọn tệp từ HTTP → Download a file làm nguồn. Để đổi tên, chọn Map trong phần nhập tệp, giữ dữ liệu đã tải và nhập tên như logo-test.svg. Tắt Convert a File để giữ định dạng SVG. Mô-đun Google Drive của Make Mở tệp đã tải lên và tìm mẫu “TEST MODE”. Đây là cách kiểm tra việc ánh xạ trong toàn bộ kịch bản.

Phản hồi từ POSTNhánh xử lý hoặc khôi phục
201 và succeededTải SVG xuống rồi tải dữ liệu tệp lên Drive.
202 và queued hoặc processingLưu ID chuyển đổi để kiểm tra trạng thái bên dưới. Giữ bộ lọc tải xuống đóng.
201 và failedGhi ID chuyển đổi và lỗi. Dừng nhánh này trước bước tải xuống.
4xx hoặc 5xxXem lỗi mô-đun và mã lỗi API nếu có. Với 429 hoặc 503, làm theo Retry-After nếu được cung cấp và dùng lại khóa, dữ liệu trong khoảng cho phép gửi lại. Nếu đang có một lượt chuyển đổi thực tế, hãy chờ xong trước.

Kiểm tra lượt chuyển đổi chưa xong trước khi tải

Kịch bản chạy một lần chỉ xử lý một tệp thử. Nếu yêu cầu thực tế trả 202, thêm mô-đun HTTP → Make a request thứ hai với GET, cùng bộ thông tin xác thực API và Parse response đặt thành Yes. Dùng cùng nguồn API với đường dẫn /v1/vectorizations/{id} rồi ánh xạ ID đã lưu vào đường dẫn. Chuyển succeeded sang nhánh tải kết quả, tiếp tục chờ ở queued và processing, còn với failed thì ghi ID và lỗi. Đợi khoảng hai giây trước khi kiểm tra lại một ID đang chờ. Chờ và xử lý bất đồng bộ trong PerfectVector

Hết thời gian chờ ở máy khách không nhất thiết làm yêu cầu dừng. Dùng ID đã lưu hoặc, nếu chưa có ID, gửi lại cùng dữ liệu ảnh và khóa trong vòng 24 giờ. Nếu đã kết thúc ở failed với timeout hoặc provider_unavailable, cần khóa mới khi thử lại. Với lỗi thứ hai, đợi đến khi nhà cung cấp hoạt động trở lại. Lưu khóa với phiên bản tệp nguồn trước khi lên lịch chạy tự động. Ghi các ID đang chờ để lần sau kiểm tra trạng thái trước khi tải lên lần nữa. Gửi lại an toàn với PerfectVector · Lỗi PerfectVector API

Chúng tôi dùng cURL và khóa thử nghiệm PerfectVector để tải ảnh lên dạng multipart, đọc bản ghi bằng ID và tải SVG mẫu cố định. Các bước Make và Google Drive dựa trên tài liệu chính thức của Make về mô-đun và ánh xạ tệp. Hãy chạy một lần trong vùng làm việc của bạn để kiểm tra việc ánh xạ.

Câu hỏi thường gặp

Tại sao kịch bản Make báo kiểu dữ liệu không được hỗ trợ?

Kiểm tra kiểu nội dung phần thân và việc ánh xạ tệp. Chọn multipart/form-data, đặt tên trường tệp là image và ánh xạ dữ liệu đầu ra từ mô-đun tải xuống. Mở tệp gốc để xác nhận đó là PNG, JPEG hoặc WebP đủ điều kiện. Giới hạn PerfectVector API

SVG thử nghiệm cho biết gì về ảnh của tôi?

Nó xác minh việc gửi yêu cầu và bàn giao tệp. PerfectVector trả mẫu cố định khi dùng khóa thử nghiệm. Để đánh giá ảnh của bạn, hãy chuyển đổi ở chế độ thực rồi kiểm tra hình dạng và màu trong kết quả. Chế độ thử nghiệm PerfectVector

Nguồn tham khảo

  1. Make — Làm việc với tệp — Ánh xạ tên và dữ liệu khi tải tệp xuống hoặc lên qua Google Drive.
  2. Make — HTTP — Tải lên multipart, phân tích JSON và tải tệp xuống trong HTTP v4.
  3. Make — Xác thực bằng khóa API — Lưu thông tin Bearer và giới hạn nguồn dịch vụ.
  4. PerfectVector — Giới hạn — Định dạng đầu vào và trường multipart được hỗ trợ.
  5. PerfectVector — Chờ và xử lý bất đồng bộ — Phần đầu chỉ định thời gian chờ và phản hồi ngay hoặc đang chờ.
  6. PerfectVector — Kết quả — Tải kết quả SVG có xác thực.
  7. PerfectVector — Chế độ thử nghiệm — SVG cố định với khóa thử nghiệm và kết quả thành công ngay.
  8. Make — Mô-đun Google Drive — Các trường tải xuống, tải lên và tùy chọn chuyển đổi tệp.

Lấy khóa thử nghiệm từ trang PerfectVector API rồi dùng ví dụ phản hồi JSON trong hướng dẫn bắt đầu với API cho một ảnh đủ điều kiện. Xác nhận thao tác tải lên trả ID chuyển đổi và kết quả tải xuống là SVG mở được.

Thêm từ blog

PerfectVector

Biến hình ảnh thành
đường vector gọn sạch, dễ chỉnh sửa

Vector hóa và kiểm tra bản xem trước miễn phí, không giới hạn theo ngày.