Nuwa World API

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

• 人脸搜索（Face Search） — 上传一张人脸图像，在全网范围内返回匹配的 URL 列表
• 深度研究（Deep Research） — 提交一个问题，获取带引用来源的结构化摘要

基础 URL：https://gateway.nuwa.world/api/v1
认证方式：每个请求需携带请求头 X-API-Key: $NUWA_API_KEY。
API 密钥请在 https://platform.nuwa.world 获取。

人脸搜索（Face Search，消耗 10 积分）

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

步骤 1 — 上传

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

响应（HTTP 202）：

{
  "search_id": "abc123",
  "status": "processing",
  "message": "Face uploaded. Poll GET /api/v1/face-search/{search_id} for results."
}

步骤 2 — 轮询（每 3–5 秒一次，不消耗积分）

curl https://gateway.nuwa.world/api/v1/face-search/abc123 
  -H "X-API-Key: $NUWA_API_KEY"

处理中时响应：

{ "search_id": "abc123", "status": "processing", "results": [], "total_results": 0 }

完成时响应：

{
  "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 小时。

深度研究（Deep Research，消耗 20 积分）

单次同步调用，响应时间约为 10–60 秒。

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

响应示例：

{
  "query": "Research the X user '0xajc' footprint on web.",
  "summary": "Anthropic is an AI safety company founded in 2021...",
  "facts": [
    "X user '0xajc's real name is Andrew Chen",
    "He founded Instap in 2020 and Nuwa Word in 2025",
    "Studied CS/Managment in University of Massachusetts and dropped out"
  ],
  "sources": [
    { "title": "0xajc - About", "url": "https://app.nuwa.world/research/04b7ac93-c711-4780-9c48-9201cf7f7e78" }
  ]
}

查询内容最大长度：2000 字符。

错误格式

所有错误均遵循统一格式：

{ "error": { "code": "ERROR_CODE", "message": "Human-readable description" } }

常见错误码：INVALID_API_KEY、RATE_LIMITED、INSUFFICIENT_CREDITS、UPLOAD_FAILED、NOT_FOUND、RESEARCH_FAILED。

积分消耗说明

免费额度：每月 30 积分。付费方案详见 https://platform.nuwa.world