网页搜索

独立的搜索接口。不是模型，按调用次数计费。

GET https://www.zzcraft.cn/v1/search

请求

参数	类型	必填	说明
q	string	是	搜索关键词
limit	integer	否	返回条数，1–20，默认 8

curl "https://www.zzcraft.cn/v1/search?q=Go语言泛型&limit=5" \
  -H "Authorization: Bearer sk-你的令牌"

返回

{
  "query": "Go语言泛型",
  "results": [
    {
      "title": "Go 语言泛型 - 菜鸟教程",
      "url": "https://www.runoob.com/go/go-generics.html",
      "snippet": "泛型是 Go 语言在 1.18 版本中引入的重要特性……",
      "engine": "google"
    }
  ],
  "elapsedMs": 1240
}

计费

每次调用固定 $0.00125，即 800 次 1 美元。不按 token 算，结果条数不影响价格。

失败的调用不收费——上游出错、参数为空、余额不足，都在扣费之前就返回了。

和模型调用的区别

	网页搜索	模型调用
接口	GET /v1/search	POST /v1/chat/completions
计费	按次，固定价	按 token
返回	网页标题+链接+摘要	模型生成的文本
用途	找资料	生成内容

搜索只返回原始网页结果，不生成答案。需要总结的话，把结果喂给模型：

# 先搜
results = requests.get(
    "https://www.zzcraft.cn/v1/search",
    params={"q": "Go 泛型", "limit": 5},
    headers={"Authorization": f"Bearer {key}"}
).json()

# 再让模型总结
context = "\n\n".join(
    f"{r['title']}\n{r['snippet']}" for r in results["results"]
)
resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{
        "role": "user",
        "content": f"根据以下资料回答问题：Go 泛型有什么用？\n\n{context}"
    }]
)

两次调用分别计费：搜索 $0.00125 + 模型按 token 算。

后台测试页

登录后可以打开 控制台 → 网页搜索，在页面上直接搜，会显示本次扣费金额。