nuwa-world-api
通过 Nuwa World API 进行人脸搜索和深度研究——来自开放网络的视觉识别智能和知识合成。
安装 / 下载方式
TotalClaw CLI推荐
totalclaw install totalclaw:totalclaw~andrewchen-oss-nuwa-world-osint-human-researchcURL直接下载，无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~andrewchen-oss-nuwa-world-osint-human-research/file -o andrewchen-oss-nuwa-world-osint-human-research.md# Nuwa World API
Two capabilities via `gateway.nuwa.world`:
- **Face Search** — upload a face image, get matching URLs across the internet
- **Deep Research** — submit a question, get a structured summary with citations
Base URL: `https://gateway.nuwa.world/api/v1`
Auth: `X-API-Key: $NUWA_API_KEY` header on every request.
Get your key at https://platform.nuwa.world
---
## Face Search (10 credits)
Two-step async flow: upload → poll.
### Step 1 — Upload
```bash
curl -X POST https://gateway.nuwa.world/api/v1/face-search \
-H "X-API-Key: $NUWA_API_KEY" \
-F "image=@photo.jpg"
```
Response (HTTP 202):
```json
{
"search_id": "abc123",
"status": "processing",
"message": "Face uploaded. Poll GET /api/v1/face-search/{search_id} for results."
}
```
### Step 2 — Poll (every 3–5 seconds, no credit cost)
```bash
curl https://gateway.nuwa.world/api/v1/face-search/abc123 \
-H "X-API-Key: $NUWA_API_KEY"
```
While processing:
```json
{ "search_id": "abc123", "status": "processing", "results": [], "total_results": 0 }
```
When done:
```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
}
```
Processing takes 15–30 seconds. Results expire after 2 hours.
---
## Deep Research (20 credits)
Single synchronous call. Returns in 10–60 seconds.
```bash
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"}'
```
Response:
```json
{
"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" }
]
}
```
Query max length: 2000 characters.
---
## Error format
All errors follow:
```json
{ "error": { "code": "ERROR_CODE", "message": "Human-readable description" } }
```
Common codes: `INVALID_API_KEY`, `RATE_LIMITED`, `INSUFFICIENT_CREDITS`, `UPLOAD_FAILED`, `NOT_FOUND`, `RESEARCH_FAILED`.
---
## Credit costs
| Endpoint | Credits |
|----------|---------|
| Face Search (upload) | 10 |
| Face Search (poll) | 0 |
| Deep Research | 20 |
Free tier: 30 credits/month. Plans at https://platform.nuwa.world
---
## 中文说明
# Nuwa World API
通过 `gateway.nuwa.world` 提供两项能力：
- **Face Search（人脸搜索）** — 上传一张人脸图像，获取互联网上匹配的 URL
- **Deep Research（深度研究）** — 提交一个问题，获取带引用来源的结构化摘要
Base URL：`https://gateway.nuwa.world/api/v1`
认证：每个请求都需带 `X-API-Key: $NUWA_API_KEY` 请求头。
在 https://platform.nuwa.world 获取你的密钥
---
## Face Search（10 积分）
两步异步流程：上传 → 轮询。
### 第 1 步 — 上传
```bash
curl -X POST https://gateway.nuwa.world/api/v1/face-search \
-H "X-API-Key: $NUWA_API_KEY" \
-F "image=@photo.jpg"
```
响应（HTTP 202）：
```json
{
"search_id": "abc123",
"status": "processing",
"message": "Face uploaded. Poll GET /api/v1/face-search/{search_id} for results."
}
```
### 第 2 步 — 轮询（每 3–5 秒一次，不消耗积分）
```bash
curl https://gateway.nuwa.world/api/v1/face-search/abc123 \
-H "X-API-Key: $NUWA_API_KEY"
```
处理中时：
```json
{ "search_id": "abc123", "status": "processing", "results": [], "total_results": 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 小时后过期。
---
## Deep Research（20 积分）
单次同步调用。在 10–60 秒内返回。
```bash
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"}'
```
响应：
```json
{
"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" }
]
}
```
Query 最大长度：2000 个字符。
---
## 错误格式
所有错误遵循以下格式：
```json
{ "error": { "code": "ERROR_CODE", "message": "Human-readable description" } }
```
常见代码：`INVALID_API_KEY`、`RATE_LIMITED`、`INSUFFICIENT_CREDITS`、`UPLOAD_FAILED`、`NOT_FOUND`、`RESEARCH_FAILED`。
---
## 积分成本
| Endpoint | Credits |
|----------|---------|
| Face Search (upload) | 10 |
| Face Search (poll) | 0 |
| Deep Research | 20 |
免费套餐：每月 30 积分。套餐详见 https://platform.nuwa.world