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

Pexafy là một công cụ tìm kiếm hình ảnh dựa trên AI, tổng hợp hàng triệu hình ảnh miễn phí từ 9 nguồn — Unsplash, Pexels, Pixabay, Kaboompics, Burst và nhiều nguồn khác — vào một API duy nhất. Một yêu cầu Pexafy = một lần tìm kiếm ngữ nghĩa trên toàn bộ 9 nguồn. Với các API riêng của nhà cung cấp, cùng một tìm kiếm cần 3 đến 5 lần gọi, cộng thêm logic hợp nhất và chuẩn hóa JSON: code bạn phải viết, bảo trì và trả tiền.

Đăng ký tài khoản miễn phí tại pexafy.com/auth/register/, sau đó vào Dashboard → API Keys → Create Key. Key đầu tiên của bạn được tạo ngay lập tức mà không cần thẻ tín dụng. Gói miễn phí bao gồm 5K yêu cầu API mỗi tháng.

Không. Khóa API của bạn hoạt động ngay từ lần gọi đầu tiên: không cần xét duyệt ứng dụng, không có thời gian chờ và không bắt buộc phải thực hiện lệnh gọi theo dõi lượt tải xuống cho mỗi lần tải. Unsplash giới hạn các ứng dụng chưa được phê duyệt ở mức 50 yêu cầu/giờ cho đến khi xét duyệt ứng dụng của bạn; Pexels cho phép 200/giờ.

Có! Gói Free cho bạn 5K yêu cầu API mỗi tháng — không cần thẻ tín dụng — và tìm kiếm trên mọi nguồn mà Pexafy lập chỉ mục, giống như mọi gói khác. Cần thêm yêu cầu? Các gói trả phí, từ Starter đến Enterprise, nâng giới hạn lên: xem trang Bảng giá của chúng tôi.

Pexafy hiện tổng hợp 9 nguồn, lớn nhất là Unsplash, Pexels, Pixabay, Kaboompics, Burst. Chúng tôi liên tục bổ sung thêm. Bạn có thể lọc kết quả theo nguồn bằng tham số source trong API.

Pexafy là một API dành cho nhà phát triển, không phải công cụ tìm kiếm dành cho người dùng thông thường. Chúng tôi chỉ tổng hợp các nguồn miễn phí và Creative Commons, vì vậy mọi kết quả đều an toàn để sử dụng trong sản phẩm của bạn. Mô hình AI của chúng tôi hiểu ý nghĩa ngữ nghĩa — tìm kiếm 'cozy autumn vibes' và nhận được hình ảnh phù hợp, không chỉ khớp từ khóa đơn thuần. Ngoài ra, bạn còn nhận được phản hồi JSON có cấu trúc, phân trang, bộ lọc và phân tích sử dụng — tất cả thông qua một REST API duy nhất.

Hiện tại chúng tôi cung cấp REST API với tài liệu toàn diện. SDK chính thức cho Python, JavaScript/TypeScript và PHP đang trong lộ trình phát triển. Trong thời gian chờ đợi, API rất dễ tích hợp — chỉ cần một yêu cầu HTTPS duy nhất với header chứa API key. Xem tài liệu của chúng tôi để biết các ví dụ code bằng nhiều ngôn ngữ khác nhau.

Giới hạn tốc độ tùy thuộc vào gói của bạn: Miễn phí — 20 yêu cầu/phút, Pro — 60 yêu cầu/phút, Business — 300 yêu cầu/phút. Nếu vượt quá giới hạn, bạn sẽ nhận được phản hồi 429 Too Many Requests với header Retry-After cho biết thời điểm bạn có thể thử lại.

Tất cả phản hồi đều là JSON với cấu trúc chuẩn: {success, data, meta, pagination, error}. Mỗi đối tượng ảnh bao gồm: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors và relevance score.

Pexafy sử dụng phân trang dựa trên con trỏ. Mỗi phản hồi bao gồm giá trị pagination.next_cursor. Truyền giá trị này làm tham số cursor trong yêu cầu tiếp theo để lấy trang kế tiếp. Khi next_cursor là null, bạn đã đến trang cuối cùng.

Có! Bạn có thể lọc theo: color_name (red, blue, green…), color_hex (ví dụ: #FF5733 với color_tolerance tùy chọn), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) và score_threshold (mức độ liên quan tối thiểu từ 0.0–1.0). Kết hợp các bộ lọc để có kết quả chính xác hơn.

Thêm API key của bạn vào header của yêu cầu: X-Api-Key: pxfy_your_key_here. Ngoài ra, bạn có thể sử dụng xác thực Bearer token: Authorization: Bearer <jwt_token>. Không bao giờ chia sẻ API key của bạn trong code phía client.

Bạn có thể yêu cầu tối đa 80 kết quả mỗi trang bằng tham số per_page (mặc định là 20). Đối với tập kết quả lớn, hãy sử dụng phân trang dựa trên con trỏ để tải các trang tiếp theo. Không có giới hạn về tổng số trang bạn có thể phân trang.

Có! Mô hình của chúng tôi được huấn luyện trên dữ liệu đa ngôn ngữ, vì vậy bạn có thể tìm kiếm bằng tiếng Anh, tiếng Pháp, tiếng Tây Ban Nha, tiếng Đức, tiếng Bồ Đào Nha và nhiều ngôn ngữ khác. Khả năng hiểu ngữ nghĩa hoạt động tốt nhất bằng tiếng Anh, nhưng hầu hết các truy vấn thông thường bằng ngôn ngữ khác vẫn cho kết quả chính xác. Chúng tôi khuyến nghị sử dụng tiếng Anh để đạt độ chính xác tối đa.

Có, bạn có thể đổi gói bất cứ lúc nào tại Dashboard → Billing. Thay đổi có hiệu lực ngay và Creem, đơn vị bán lại của chúng tôi, tính theo tỷ lệ: chuyển lên gói cao hơn sẽ bị tính phần chênh lệch giá cho thời gian còn lại của kỳ hiện tại, chuyển xuống gói thấp hơn sẽ được hoàn lại phần đó.

Các yêu cầu API sẽ bị chặn khi bạn đạt đến giới hạn hàng tháng — bạn sẽ nhận được phản hồi 429 kèm thông báo lỗi chi tiết. Để tiếp tục sử dụng API, hãy nâng cấp lên gói cao hơn từ Dashboard → Billing.

Chúng tôi cung cấp bảo đảm hoàn tiền trong 14 ngày cho tất cả các gói trả phí. Nếu bạn không hài lòng trong 14 ngày đầu tiên kể từ khi đăng ký, hãy liên hệ với chúng tôi tại [email protected] và chúng tôi sẽ hoàn tiền đầy đủ, không cần giải thích. Creem, đơn vị bán lại của chúng tôi, sẽ hoàn tiền về phương thức thanh toán ban đầu của bạn. Chi tiết trong Chính sách hoàn tiền: pexafy.com/legal/refund/

Các khoản thanh toán do Creem, đơn vị bán lại và Merchant of Record của chúng tôi, xử lý. Bạn có thể thanh toán bằng thẻ tín dụng hoặc thẻ ghi nợ, hoặc bằng các phương thức thanh toán khác mà Creem cung cấp khi thanh toán tại quốc gia của bạn. Chúng tôi không bao giờ xem hay lưu trữ thông tin thẻ của bạn.

Không có hợp đồng, không có ràng buộc. Tất cả các gói đều theo tháng (hoặc theo năm với mức giảm giá nếu bạn chọn). Hủy bất cứ lúc nào từ Dashboard → Billing chỉ với một cú nhấp chuột. Quyền truy cập của bạn sẽ tiếp tục cho đến hết kỳ thanh toán hiện tại.

Có! Thanh toán theo năm giúp tiết kiệm lên đến 18%: Gói Pro là $199/năm ($17/tháng) thay vì $19/tháng. Gói Business là $2599/năm ($217/tháng) thay vì $249/tháng. Chuyển sang thanh toán theo năm từ Dashboard → Billing.

Có! Nếu nhu cầu của bạn vượt quá gói Enterprise — giới hạn tốc độ cao hơn, cơ sở hạ tầng riêng, SLA tùy chỉnh, hoặc triển khai tại chỗ — hãy liên hệ với chúng tôi tại [email protected] cùng với yêu cầu của bạn. Chúng tôi sẽ xây dựng một gói phù hợp cho tổ chức của bạn.

Mọi mức giá đều niêm yết bằng USD và Creem, đơn vị bán lại của chúng tôi, thu bằng USD. Tùy quốc gia của bạn, thuế như VAT có thể được cộng thêm khi thanh toán. Nếu thẻ của bạn dùng loại tiền tệ khác, ngân hàng sẽ quy đổi số tiền và có thể tính một khoản phí chuyển đổi ngoại tệ nhỏ.

Không. Pexafy là một công cụ tìm kiếm — chúng tôi lập chỉ mục và tìm kiếm các hình ảnh được lưu trữ trên các nền tảng bên thứ ba (Unsplash, Pexels, Pixabay, v.v.). Chúng tôi không lưu trữ, host, hoặc phân phối lại các tệp hình ảnh thực tế. Tất cả hình ảnh vẫn là tài sản của các nhiếp ảnh gia và nền tảng tương ứng.

Điều này phụ thuộc vào giấy phép của từng nguồn. Unsplash, Pexels và Pixabay đều cung cấp giấy phép sử dụng thương mại miễn phí cho hầu hết hình ảnh của họ, và các nguồn nhỏ hơn mà chúng tôi lập chỉ mục cũng theo mô hình tương tự. Hãy luôn kiểm tra trường license trong phản hồi API và xác minh tại URL nguồn trước khi sử dụng hình ảnh cho mục đích thương mại.

Không. Pexafy không bán hình ảnh. Mỗi kết quả đều đến từ một thư viện được dùng miễn phí — Unsplash, Pexels, Pixabay, Kaboompics, Burst và các nguồn khác — và dẫn liên kết về đó, theo giấy phép riêng của thư viện ấy. Gói của bạn chỉ trả cho dịch vụ tìm kiếm: yêu cầu API, giới hạn tốc độ, khóa API và hỗ trợ. Hãy kiểm tra giấy phép của từng hình ảnh tại nguồn trước khi sử dụng.

Pexafy trả về URL đến các hình ảnh được lưu trữ trên nền tảng gốc của chúng — chúng tôi không phục vụ tệp hình ảnh trực tiếp qua API. Bạn có thể tải xuống hình ảnh độ phân giải đầy đủ từ URL nguồn được cung cấp trong phản hồi. Hãy luôn tuân thủ điều khoản dịch vụ của nền tảng nguồn.

Quy trình lập chỉ mục của chúng tôi chạy hàng ngày cho tất cả các nguồn lớn. Hình ảnh mới được tải lên Unsplash, Pexels, Pixabay và các nền tảng khác thường có thể tìm kiếm qua Pexafy trong vòng 24–48 giờ. Chỉ mục của chúng tôi hiện chứa 9M+ hình ảnh và đang tăng trưởng mỗi ngày.

Truy cập Dashboard → Settings → Danger Zone → Delete Account. Việc xóa tài khoản là vĩnh viễn và sẽ xóa toàn bộ API key, lịch sử sử dụng và dữ liệu cá nhân của bạn. Bạn cũng có thể gửi email cho chúng tôi tại [email protected] để yêu cầu xóa theo GDPR/quyền xóa dữ liệu.

Có. Chúng tôi sử dụng HTTPS trên toàn bộ hệ thống, bcrypt để băm mật khẩu và lưu trữ phiên trong Redis với JWT token có thời gian sống ngắn. Chúng tôi không bán hoặc chia sẻ dữ liệu của bạn với bên thứ ba. API key được băm trước khi lưu trữ. Đọc Chính sách Bảo mật của chúng tôi để biết đầy đủ thông tin về quy trình xử lý dữ liệu.

Có, tùy thuộc vào gói của bạn: Free (1 key), Pro (5 key), Business (∞ key). Nhiều key cho phép bạn phân tách mức sử dụng theo ứng dụng, môi trường (dev/staging/prod) hoặc thành viên nhóm, đồng thời thu hồi từng key riêng lẻ mà không ảnh hưởng đến các key khác.

Hãy thu hồi ngay key bị lộ từ Dashboard → API Keys và tạo key mới. Việc thu hồi có hiệu lực ngay lập tức — mọi yêu cầu sử dụng key cũ sẽ bị từ chối với lỗi 401. Đừng bao giờ commit API key vào hệ thống quản lý phiên bản; hãy sử dụng biến môi trường thay thế.

Chúng tôi hướng tới thời gian hoạt động 99,9% cho khả năng sẵn sàng của API. Khách hàng gói Business nhận được SLA với cam kết về thời gian hoạt động. Bạn có thể theo dõi trạng thái dịch vụ theo thời gian thực và lịch sử trên trang Trạng thái của chúng tôi, có thể truy cập từ chân trang của trang web này.

Có. Chúng tôi chỉ thu thập dữ liệu tối thiểu cần thiết để vận hành dịch vụ (email, mật khẩu đã băm, nhật ký sử dụng). Chúng tôi không bán dữ liệu cho bên thứ ba. Bạn có thể yêu cầu xuất toàn bộ dữ liệu hoặc xóa dữ liệu bất cứ lúc nào từ Dashboard → Settings hoặc bằng cách gửi email đến [email protected]. Xem Chính sách Bảo mật của chúng tôi để biết đầy đủ thông tin.