常见问题

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

入门指南

Pexafy 是什么?

Pexafy 是一款 AI 驱动的图片搜索引擎,将来自 9 个来源(包括 Unsplash, Pexels, Pixabay, Kaboompics, Burst 等)的数百万张可免费使用的图片整合至单一 API。一次 Pexafy 请求 = 跨全部 9 个来源的语义搜索。使用各服务商自有 API 完成相同搜索需要 3 至 5 次调用,外加数据合并逻辑与 JSON 标准化处理——这些代码均由您自行编写、维护并承担费用。

如何获取 API 密钥?

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

我需要申请审核才能使用吗?

不需要。您的密钥在第一次调用时即可使用:无需应用审核,无需等待期,也无需在每次下载时强制调用下载追踪接口。Unsplash 对未审核应用限制为每小时 50 次请求,直至完成审核;Pexels 允许每小时 200 次。

Pexafy 可以免费使用吗?

是的!Free 套餐每月为您提供 5K 次 API 请求——无需信用卡——并且和其他所有套餐一样,可搜索 Pexafy 索引的全部来源。需要更多请求?从 Starter 到 Enterprise 的付费套餐会提高限额:请查看我们的定价页面。

Pexafy 搜索哪些图片来源?

Pexafy 目前整合了 9 个来源,其中最主要的包括 Unsplash, Pexels, Pixabay, Kaboompics, Burst。我们持续接入更多来源。您可以在 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 是否支持多语言搜索查询?

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

账单与套餐

我可以更改套餐吗?

可以,随时在控制台 → 账单中切换套餐。变更立即生效,由我们的经销商 Creem 按比例计算:升级到更高套餐时,收取当前周期剩余时间的差价;降级到更低套餐时,退还该差价。

超出配额后会发生什么?

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

你们提供退款吗?

我们为所有付费套餐提供 14 天退款保证。如果您在订阅后的前 14 天内不满意,请发送邮件至 [email protected] 联系我们,我们将无条件全额退款。退款由我们的经销商 Creem 原路退回至您的付款方式。详情请参阅我们的退款政策:pexafy.com/legal/refund/

你们接受哪些付款方式?

付款由我们的经销商兼 Merchant of Record(记录商户)Creem 处理。您可以使用信用卡或借记卡付款,也可以使用 Creem 在您所在国家/地区结账时提供的其他付款方式。我们从不查看或存储您的银行卡信息。

是否需要签订长期合同?

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

是否有年付折扣?

有!选择年付最多可节省 18%:Pro 套餐为 $199/年($17/月),而非 $19/月;Business 套餐为 $2599/年($217/月),而非 $249/月。可在控制台 → 账单中切换至年付。

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

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

你们支持哪些货币付款?

所有价格均以美元(USD)标价,由我们的经销商 Creem 以美元收取。根据您所在的国家/地区,结账时可能会加收增值税等税费。如果您的银行卡使用其他币种,您的银行会进行换算,并可能收取少量外汇手续费。

图片与授权

Pexafy 拥有这些图片吗?

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

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

这取决于来源的许可协议。Unsplash、Pexels 和 Pixabay 的大多数图片均提供免费商业使用许可,我们收录的其他较小来源也遵循相同模式。在将图片用于商业用途之前,请务必核查 API 响应中的 license 字段,并在来源 URL 处进行确认。

图片需要付费吗?

不需要。Pexafy 不出售图片。每个结果都来自可免费使用的图库(Unsplash, Pexels, Pixabay, Kaboompics, Burst 等),并链接回原图库,适用该图库自己的许可协议。您的套餐只为搜索服务付费:API 请求、速率限制、API 密钥和支持。使用前请在来源处核实每张图片的许可。

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

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

图片索引多久更新一次?

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

账户与安全

如何删除我的账户?

前往 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 博客