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

Pexafy là một công cụ tìm kiếm hình ảnh được hỗ trợ bởi AI, tổng hợp hàng triệu hình ảnh miễn phí và trả phí từ nhiều nguồn — Unsplash, Pexels, Pixabay, Wikimedia Commons và nhiều hơn nữa — vào một API duy nhất. Thay vì tích hợp hàng chục dịch vụ hình ảnh, bạn chỉ cần gửi một yêu cầu đến Pexafy và nhận được kết quả tốt nhất từ tất cả các nguồn, được xếp hạng theo mức độ liên quan ngữ nghĩa bởi AI.

Đă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 1K yêu cầu API mỗi tháng.

Có! Gói Miễn phí của chúng tôi cung cấp cho bạn 1K yêu cầu API mỗi tháng — không cần thẻ tín dụng. Bạn có thể tìm kiếm bằng truy vấn văn bản và truy cập tất cả các nguồn hình ảnh miễn phí. Cần thêm yêu cầu, hình ảnh cao cấp hoặc tìm kiếm hình ảnh theo hình ảnh? Hãy xem trang Pricing để biết về các gói Pro và Business.

Pexafy hiện tổng hợp hình ảnh từ Unsplash, Pexels, Pixabay, Wikimedia Commons và Openverse. Chúng tôi liên tục bổ sung thêm các nguồn mới. 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ể nâng cấp hoặc hạ cấp bất cứ lúc nào từ Dashboard → Billing. Việc nâng cấp có hiệu lực ngay lập tức với thanh toán theo tỷ lệ. Việc hạ cấp có hiệu lực vào cuối kỳ thanh toán hiện tại. Tất cả được xử lý tự động qua Stripe.

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.

Chúng tôi chấp nhận tất cả các thẻ tín dụng và thẻ ghi nợ phổ biến (Visa, Mastercard, American Express), cũng như Apple Pay và Google Pay — tất cả được xử lý bảo mật qua Stripe. Chúng tôi không lưu trữ bất kỳ thông tin thanh toán nào trên máy chủ của mình.

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 khoảng 17%: Gói Pro là $290/năm ($24/tháng) thay vì $29/tháng. Gói Business là $2990/năm ($249/tháng) thay vì $299/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 Business — 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.

Tất cả giá được niêm yết bằng USD. Stripe, đơn vị xử lý thanh toán của chúng tôi, sẽ tự động chuyển đổi sang đơn vị tiền tệ địa phương của bạn khi thanh toán. Ngân hàng của bạn có thể áp dụng một khoản phí ngoại hối nhỏ tùy thuộc vào loại thẻ và quốc gia của bạn.

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 đó phụ thuộc vào giấy phép của nguồn ảnh. 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ọ. Wikimedia Commons và Openverse sử dụng nhiều loại giấy phép Creative Commons khác nhau — một số cho phép sử dụng thương mại, một số thì không. Hãy luôn kiểm tra trường giấy phép 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.

Hình ảnh cao cấp xuất hiện trong kết quả tìm kiếm nhưng có thể yêu cầu đăng ký hoặc mua tại nguồn để tải xuống ở độ phân giải đầy đủ. API trả về bản xem trước/thumbnail cho tất cả hình ảnh. Với gói Free và Pro, URL nguồn trong phản hồi sẽ cho bạn biết nơi truy cập hình ảnh đầy đủ.

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. Đối với hình ảnh miễn phí (Unsplash, Pexels, Pixabay), 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 hơn 5 triệu 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.