完整文档

{
  "request_id": "r_m3x0kq9v2d4tq7a1",
  "provider": "deepseek",
  "provider_requested": "auto",
  "provider_preference_honored": true,
  "answer": null,
  "sources": [
    {
      "title": "杭州三日游攻略：路线、交通与住宿",
      "url": "https://example.com/hangzhou-3d2n",
      "snippet": "这份杭州3天2晚攻略包含景点路线、交通、住宿、美食和游玩tips……",
      "publishedAt": "2026-10-26T16:00:00.000Z",
      "domain": "example.com",
      "score": 0.5471,
      "scoreRaw": 1.6412975788116455,
      "scoreScale": "0-3"
    }
  ],
  "snapshot_url": "https://search.ozforce.cn/s/0m0sfptw98xs",
  "h5_url": "https://search.ozforce.cn/s/0m0sfptw98xs",
  "latency_ms": 469,
  "usage": {
    "count": 3,
    "credits_charged": 1,
    "credits_base": 1,
    "tier_discount": 1,
    "floor_applied": false,
    "balance_after": 499,
    "quota_source": "balance"
  },
  "quality": { "usable": 3, "gate_passed": true },
  "degraded": false,
  "degraded_reason": null
}

# 第一个请求：结果档 l1 —— 拿回来源列表 + 一条永久快照链接
curl -sS -X POST "https://search.ozforce.cn/v1/search" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"杭州 三日游 攻略","count":5,"freshness":"month","snapshot":true}'

rem Windows 命令行（cmd.exe）：在同一窗口先 set WS_API_KEY=你的key，再粘贴下一行
curl -sS -X POST "https://search.ozforce.cn/v1/search" -H "Authorization: Bearer %WS_API_KEY%" -H "Content-Type: application/json" -d "{\"q\":\"杭州 三日游 攻略\",\"count\":5,\"freshness\":\"month\",\"snapshot\":true}"

// 存成 first.mjs，然后：node first.mjs（Node 18+ 自带 fetch，不用装任何包）
const BASE = 'https://search.ozforce.cn'
const KEY = process.env.WS_API_KEY
if (!KEY) {
  console.error('先设置环境变量 WS_API_KEY（值是你的 API key）')
  process.exit(1)
}

const res = await fetch(BASE + '/v1/search', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ q: '杭州 三日游 攻略', count: 5, freshness: 'month', snapshot: true })
})

const data = await res.json()
if (!res.ok) {
  console.error('失败', res.status, data.error)
  process.exit(1)
}

console.log('扣费', data.usage.credits_charged, 'credits，余额', data.usage.balance_after)
console.log('永久链接', data.snapshot_url)
for (const s of data.sources) console.log('-', s.title, s.url)

# Python 3.8+，只用标准库
import json, os, urllib.request

BASE = 'https://search.ozforce.cn'
KEY = os.environ.get('WS_API_KEY')
if not KEY:
    raise SystemExit('先设置环境变量 WS_API_KEY（值是你的 API key）')

body = json.dumps({'q': '杭州 三日游 攻略', 'count': 5, 'freshness': 'month', 'snapshot': True}).encode('utf-8')
req = urllib.request.Request(
    BASE + '/v1/search', data=body, method='POST',
    headers={'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json'},
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read().decode('utf-8'))

print('扣费', data['usage']['credits_charged'], 'credits，余额', data['usage']['balance_after'])
print('永久链接', data['snapshot_url'])
for s in data['sources']:
    print('-', s['title'], s['url'])

{
  "request_id": "r_qms0v6hx8m4nah3j",
  "product": "l1_answer",
  "requested_product": "l1_answer",
  "depth": "fast",
  "charged": 2,
  "refunded": false,
  "deliverable": true,
  "provider": "deepseek",
  "answer": "天空的蓝色是阳光与大气分子、冰晶、水滴等共同作用的结果……蓝色光更容易被散射并进入人眼，因此天空呈蓝色 [1][2][3]。",
  "answer_source": "summarizer",
  "citations": [1, 2, 3],
  "cited": true,
  "depth_degraded": false,
  "answer_model": "deepseek",
  "summary": {
    "model": "deepseek-flash",
    "tokens_in": 473,
    "tokens_out": 91,
    "cost_cny": 0.001783,
    "latency_ms": 1179,
    "cached": false
  },
  "sources": [{ "title": "天空为什么是蓝色的", "url": "https://example.com/sky-blue", "domain": "example.com", "score": 0.6648 }],
  "snapshot_url": "https://search.ozforce.cn/s/peh58hj5m8wt",
  "latency_ms": { "search": 523, "answer": 1183, "total": 1706 },
  "usage": {
    "count": 3,
    "credits_charged": 2,
    "search_cny": 0.005,
    "fetch_cny": 0,
    "writer_cny": 0.001783,
    "balance_after": 497
  },
  "degraded": false
}

# 快答案档：读片段写答案（同一个端点，不传 depth 就是 fast）
curl -sS -X POST "https://search.ozforce.cn/v1/answer" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"天空为什么是蓝色的","count":5}'

# 快答案档（不传 depth）
import json, os, urllib.request

BASE = 'https://search.ozforce.cn'
KEY = os.environ.get('WS_API_KEY')
if not KEY:
    raise SystemExit('先设置环境变量 WS_API_KEY')

body = json.dumps({'q': '天空为什么是蓝色的', 'count': 5}).encode('utf-8')
req = urllib.request.Request(
    BASE + '/v1/answer', data=body, method='POST',
    headers={'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json'},
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read().decode('utf-8'))

print(data['answer'])
print('引用编号', data['citations'], '永久链接', data['snapshot_url'])

# 深答案档：同一个端点 + depth:"deep"（会真去抓原文，更准也更慢）
curl -sS -X POST "https://search.ozforce.cn/v1/answer" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"天空为什么是蓝色的","depth":"deep","count":8}'

// 深答案：答案 + 引用编号 + 材料清单（读了哪几篇原文）
const BASE = 'https://search.ozforce.cn'
const KEY = process.env.WS_API_KEY
if (!KEY) { console.error('先设置环境变量 WS_API_KEY'); process.exit(1) }

const res = await fetch(BASE + '/v1/answer', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ q: '天空为什么是蓝色的', depth: 'deep', count: 8 })
})
const data = await res.json()
if (!res.ok) { console.error('失败', res.status, data.error); process.exit(1) }

console.log(data.answer)
console.log('引用编号', data.citations.join(','), '· 是否带引用', data.cited)
console.log('读了', data.materials.length, '篇材料，永久链接', data.snapshot_url)

{
  "request_id": "r_8kq2s9v1n0xb7t3c",
  "middleware": "m1",
  "unit": "news",
  "name": "即时新闻",
  "domain": "news",
  "result_schema": "news.v1",
  "snapshot_policy": "freeze",
  "items": [
    {
      "title": "人工智能，加速融入你我生活",
      "summary": "在广东佛山，巡检无人机用上AI算法，为城市治理提供精准依据……",
      "source": "example.com",
      "url": "https://example.com/ai-news",
      "publishedAt": "2026-10-28T16:00:00.000Z",
      "heat": 84
    }
  ],
  "snapshot_url": "https://search.ozforce.cn/s/j5zj1m22mxfr",
  "live_url": "https://search.ozforce.cn/u/m1/news",
  "h5_url": "https://search.ozforce.cn/u/m1/news",
  "primary_url": "https://search.ozforce.cn/s/j5zj1m22mxfr",
  "answer": null,
  "served_from": "live",
  "cost_source": "live_search",
  "usage": { "credits_charged": 1, "balance_after": 496 },
  "degraded": false
}

# 二级单元：m1/wiki（结果结构更贴合该领域，价格见页面上的单元卡片）
curl -sS -X POST "https://search.ozforce.cn/v2/m1/wiki/run" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"人工智能","count":5,"snapshot":true}'

// 二级单元 m1/wiki：返回 items[]（结构按单元的 resultSchema）
const BASE = 'https://search.ozforce.cn'
const KEY = process.env.WS_API_KEY
if (!KEY) { console.error('先设置环境变量 WS_API_KEY'); process.exit(1) }

const res = await fetch(BASE + '/v2/m1/wiki/run', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ q: '人工智能', count: 5, snapshot: true })
})
const data = await res.json()
if (!res.ok) { console.error('失败', res.status, data.error); process.exit(1) }

console.log('共', data.items.length, '条，扣费', data.usage.credits_charged, 'credits')
console.log('永久链接', data.snapshot_url)
for (const item of data.items) console.log('-', item.title, item.url)

# 二级单元 m1/wiki
import json, os, urllib.request

BASE = 'https://search.ozforce.cn'
KEY = os.environ.get('WS_API_KEY')
if not KEY:
    raise SystemExit('先设置环境变量 WS_API_KEY')

body = json.dumps({'q': '人工智能', 'count': 5, 'snapshot': True}).encode('utf-8')
req = urllib.request.Request(
    BASE + '/v2/m1/wiki/run', data=body, method='POST',
    headers={'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json'},
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read().decode('utf-8'))

print('共', len(data['items']), '条，扣费', data['usage']['credits_charged'], 'credits')
print('永久链接', data['snapshot_url'])

# 永久快照：把上面响应里的 snapshot_url 原样打开即可（不需要 key）
#   https://search.ozforce.cn/s/<token>        人读的 HTML 页
#   https://search.ozforce.cn/s/<token>.json   原始数据（长缓存、不可变）
curl -sS "https://search.ozforce.cn/s/<token>.json"

# 单元目录（公开，不要 key）
curl -sS "https://search.ozforce.cn/v1/units"

# 商品目录（公开，不要 key）：每个商品的价格与 rent_scope
curl -sS "https://search.ozforce.cn/v1/catalog"