Nuwa World API

通过 gateway.nuwa.world 提供两项功能：

• - 人脸搜索 — 上传人脸图像，获取互联网上的匹配链接
• 深度研究 — 提交问题，获取带引用的结构化摘要

基础 URL：https://gateway.nuwa.world/api/v1
认证：每次请求需在请求头中添加 X-API-Key: $NUWAAPIKEY。
获取密钥：https://platform.nuwa.world

人脸搜索（10 积分）

两步异步流程：上传 → 轮询。

第一步 — 上传

bash
curl -X POST https://gateway.nuwa.world/api/v1/face-search \
-H X-API-Key: $NUWAAPIKEY \
-F image=@photo.jpg

响应（HTTP 202）：

json
{
search_id: abc123,
status: processing,
message: 人脸已上传。请轮询 GET /api/v1/face-search/{search_id} 获取结果。
}

第二步 — 轮询（每 3–5 秒，不消耗积分）

bash
curl https://gateway.nuwa.world/api/v1/face-search/abc123 \
-H X-API-Key: $NUWAAPIKEY

处理中：

json
{ searchid: abc123, status: processing, results: [], totalresults: 0 }

完成时：

json
{
search_id: abc123,
status: completed,
results: [
{ index: 0, score: 95.2, url: https://example.com/profile },
{ index: 1, score: 82.1, url: https://social.example/user }
],
total_results: 2,
max_score: 95.2
}

处理时间 15–30 秒。结果 2 小时后过期。

深度研究（20 积分）

单次同步调用。10–60 秒内返回。

bash
curl -X POST https://gateway.nuwa.world/api/v1/deep-research \
-H X-API-Key: $NUWAAPIKEY \
-H Content-Type: application/json \
-d {query: 0xajc on X}

响应：

json
{
query: 研究 X 用户 0xajc 在互联网上的足迹。,
summary: Anthropic 是一家成立于 2021 年的 AI 安全公司...,
facts: [
X 用户 0xajc 的真名是 Andrew Chen,
他于 2020 年创立了 Instap，2025 年创立了 Nuwa World,
曾在马萨诸塞大学学习计算机科学/管理学，后辍学
],
sources: [
{ title: 0xajc - 关于, url: https://app.nuwa.world/research/04b7ac93-c711-4780-9c48-9201cf7f7e78 }
]
}

查询最大长度：2000 个字符。

错误格式

所有错误遵循以下格式：

json
{ error: { code: ERROR_CODE, message: 人类可读的描述 } }

常见错误码：INVALIDAPIKEY、RATELIMITED、INSUFFICIENTCREDITS、UPLOADFAILED、NOTFOUND、RESEARCH_FAILED。

积分消耗

免费套餐：每月 30 积分。套餐详情：https://platform.nuwa.world