常见问题

关于 Pexafy 你需要了解的一切。找不到答案?联系我们

入门指南

Pexafy 是什么?

Pexafy 是一款 AI 驱动的图片搜索引擎,将来自多个来源(Unsplash、Pexels、Pixabay、Wikimedia Commons 等)的数百万张免费及付费图片聚合到单一 API 中。无需集成数十个图片服务,只需向 Pexafy 发送一次请求,即可获取跨所有来源、按 AI 语义相关性排序的最佳结果。

如何获取 API 密钥?

在 pexafy.com/auth/register/ 注册免费账户,然后前往 Dashboard → API Keys → Create Key。您的第一个密钥将即时创建,无需信用卡。免费套餐每月包含 1K 次 API 请求。

Pexafy 可以免费使用吗?

当然!我们的免费套餐每月提供 1K 次 API 请求,无需信用卡。您可以进行基于文本的搜索并访问所有免费图片来源。需要更多请求次数、付费图片或以图搜图功能?请查看我们的定价页面,了解 Pro 和 Business 套餐。

Pexafy 搜索哪些图片来源?

Pexafy 目前聚合来自 Unsplash、Pexels、Pixabay、Wikimedia Commons 和 Openverse 的图片,并持续接入更多来源。您可以在 API 中使用 source 参数按来源筛选结果。

Pexafy 与 Google Images 有何不同?

Pexafy 是面向开发者的 API,而非面向普通用户的搜索引擎。我们仅聚合可免费使用及 Creative Commons 授权的图片来源,确保每条结果均可安全用于您的产品。我们的 AI 模型能理解语义含义——搜索

我们是否提供 SDK 或客户端库?

我们目前提供附有完整文档的 REST API。Python、JavaScript/TypeScript 和 PHP 的官方 SDK 已在我们的路线图上。目前,该 API 集成简单直接——只需一个带有 API 密钥请求头的 HTTPS 请求即可。请查阅我们的文档,获取多种语言的代码示例。

API 与技术

API 的速率限制是多少?

速率限制取决于您的套餐:免费版 — 20 次请求/分钟,Pro 版 — 60 次请求/分钟,Business 版 — 300 次请求/分钟。如果超出限制,您将收到 429 Too Many Requests 响应,其中包含 Retry-After 请求头,指示可重试的时间。

API 返回哪些格式?

所有响应均为 JSON 格式,采用标准信封结构:{success, data, meta, pagination, error}。每个图片对象包含:id、title、description、urls(thumbnail、small、regular、full、raw)、photographer(name、url)、source、license、dimensions、colors 以及相关性评分。

如何处理分页?

Pexafy 使用基于游标的分页方式。每次响应包含一个 pagination.next_cursor 值。将其作为 cursor 参数传入下一次请求,即可获取下一页内容。当 next_cursor 为 null 时,表示已到达末尾。

我可以筛选搜索结果吗?

当然可以!您可以按以下条件筛选:color_name(red、blue、green 等)、color_hex(例如 #FF5733,可搭配可选的 color_tolerance)、orientation(landscape、portrait、square)、source(unsplash、pexels、pixabay 等),以及 score_threshold(最低相关性,范围 0.0–1.0)。组合使用多个筛选条件可获得更精准的结果。

如何对 API 请求进行身份验证?

将您的 API 密钥添加为请求头:X-Api-Key: pxfy_your_key_here。或者使用 Bearer 令牌身份验证:Authorization: Bearer <jwt_token>。请勿在客户端代码中暴露您的 API 密钥。

每次请求最多可返回多少条结果?

您可以通过 per_page 参数每页请求最多 80 条结果(默认值为 20)。对于大型结果集,请使用基于游标的分页方式获取后续页面。您可以翻页的总页数不受限制。

Pexafy 是否支持多语言搜索查询?

支持!我们的模型基于多语言数据进行训练,您可以使用英语、法语、西班牙语、德语、葡萄牙语及其他多种语言进行搜索。语义理解在英语下效果最佳,但其他语言的常见查询通常也能获得准确结果。建议使用英语以获得最高精度。

账单与套餐

我可以更改套餐吗?

可以,您可以随时在控制台 → 账单中升级或降级套餐。升级立即生效,并按比例计费;降级将在当前计费周期结束后生效。所有操作均通过 Stripe 自动处理。

超出配额后会发生什么?

一旦达到每月限额,API 请求将被阻止——您将收到 429 响应及详细的错误信息。如需继续使用 API,请在控制台 → 账单中升级至更高套餐。

你们提供退款吗?

我们为所有付费套餐提供 14 天退款保证。如果您在订阅后的前 14 天内不满意,请发送邮件至 [email protected] 联系我们,我们将无条件全额退款。

你们接受哪些付款方式?

我们接受所有主流信用卡和借记卡(Visa、Mastercard、American Express),以及 Apple Pay 和 Google Pay——所有支付均通过 Stripe 安全处理。我们不在服务器上存储任何支付信息。

是否需要签订长期合同?

无需合同,无需承诺。所有套餐均为按月订阅(也可选择享受折扣的年付方案)。随时可在控制台 → 账单中一键取消。您的访问权限将持续至当前计费周期结束。

是否有年付折扣?

有!选择年付可节省约 17%:Pro 套餐为 $290/年($24/月),而非 $29/月;Business 套餐为 $2990/年($249/月),而非 $299/月。可在控制台 → 账单中切换至年付。

你们提供定制企业方案吗?

提供!如果您的需求超出 Business 套餐——例如更高的速率限制、专属基础设施、自定义 SLA 或本地部署——请将您的需求发送至 [email protected],我们将为您的组织量身定制方案。

你们支持哪些货币付款?

所有价格均以美元标注。我们的支付处理商 Stripe 会在结账时自动换算为您的本地货币。根据您的卡种和所在国家,您的银行可能会收取少量外汇手续费。

图片与授权

Pexafy 拥有这些图片吗?

不。Pexafy 是一个搜索引擎——我们对托管在第三方平台(Unsplash、Pexels、Pixabay 等)上的图片进行索引和搜索。我们不存储、托管或分发实际的图片文件。所有图片仍归各自的摄影师和平台所有。

我可以将图片用于商业用途吗?

这取决于来源许可证。Unsplash、Pexels 和 Pixabay 的大多数图片均提供免费商业用途许可证。Wikimedia Commons 和 Openverse 使用多种 Creative Commons 许可证——部分允许商业使用,部分不允许。在将图片用于商业用途之前,请务必查看 API 响应中的 license 字段,并在源 URL 处核实许可信息。

付费图片有何不同?

付费图片会出现在搜索结果中,但在来源平台下载完整分辨率版本时可能需要订阅或付费。API 对所有图片均返回预览图/缩略图。免费版和专业版用户可通过响应中的来源 URL 访问完整图片。

我可以通过 API 下载图片吗?

Pexafy 返回的是图片在其原始平台上的 URL——我们不通过 API 直接提供图片文件。对于免费图片(Unsplash、Pexels、Pixabay),您可以通过响应中提供的来源 URL 下载完整分辨率图片。请务必遵守来源平台的服务条款。

图片索引多久更新一次?

我们的索引流程每天对所有主要来源运行一次。上传至 Unsplash、Pexels、Pixabay 及其他平台的新图片通常在 24–48 小时内可通过 Pexafy 搜索到。我们的索引目前包含超过 500 万张图片,并且每天持续增长。

账户与安全

如何删除我的账户?

前往 Dashboard → Settings → Danger Zone → Delete Account。账户删除操作不可逆,将永久移除您的所有 API 密钥、使用记录及个人数据。您也可以发送邮件至 [email protected],依据 GDPR/被遗忘权申请删除。

我的数据安全吗?

是的。我们全站使用 HTTPS,密码采用 bcrypt 哈希处理,会话存储在 Redis 中并配合短期 JWT 令牌。我们不会向第三方出售或共享您的数据。API 密钥在存储前会进行哈希处理。请阅读我们的隐私政策,了解数据处理的完整详情。

我可以拥有多个 API 密钥吗?

可以,具体数量取决于您的套餐:免费版(1 个密钥)、专业版(5 个密钥)、商业版(∞ 个密钥)。多个密钥便于您按应用、环境(开发/测试/生产)或团队成员区分用量,并可单独撤销某个密钥而不影响其他密钥。

如果我的 API 密钥泄露了怎么办?

请立即在 Dashboard → API Keys 中撤销已泄露的密钥并创建新密钥。撤销操作即时生效——使用旧密钥发出的任何请求将收到 401 错误。切勿将 API 密钥提交到版本控制系统,请改用环境变量。

你们的正常运行时间保证是多少?

我们的 API 可用性目标为 99.9% 的正常运行时间。商业计划用户可享有包含正常运行时间承诺的 SLA 协议。您可以在我们的状态页面上监控实时及历史服务状态,该页面可通过本网站底部的链接访问。

Pexafy 符合 GDPR 规定吗?

是的。我们仅收集运营服务所需的最少数据(电子邮件、哈希密码、使用日志),不向第三方出售数据。您可随时在 Dashboard → Settings 中或发送邮件至 [email protected] 申请完整数据导出或删除。详情请参阅我们的隐私政策。

还有疑问?

找不到你想要的内容?我们的团队很乐意提供帮助。

联系支持团队 阅读 API 文档

关于 Pexafy 博客