智能搜索
基于 AI 的智能网页搜索,输入关键词返回网页结果和 AI 综合回答。支持控制结果数量和搜索深度。
GET
https://api.tinyaii.cn/v1/web/search
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| query | string | 必填 | 搜索关键词 | — |
| max_results | int | 可选 | 最大结果数(默认5,最大10) | — |
| search_depth | string | 可选 | 搜索深度:basic(快速)或 advanced(深度) | — |
| include_answer | bool | 可选 | 是否包含AI生成的回答(默认true) | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| query | string | 原始搜索关键词 |
| answer | string | AI 生成的综合回答(基于搜索结果自动总结,当 include_answer=false 时为空) |
| results | array | 网页搜索结果列表 |
| results[].title | string | 网页标题 |
| results[].url | string | 网页链接 |
| results[].content | string | 网页内容摘要 |
| results[].score | number | 与查询的相关度评分(0~1,越高越相关) |
返回示例
{
"code": 200,
"message": "success",
"data": {
"query": "Rust语言",
"answer": "Rust 是一门系统编程语言,专注于安全性、并发性和高性能,无需垃圾回收器。支持多种编程范式,广泛用于嵌入式、Web 服务等领域。",
"results": [
{
"title": "Rust语言圣经 - GitHub",
"url": "https://github.com/sunface/rust-course",
"content": "Rust语言圣经涵盖从入门到精通所需的 Rust 知识,目录及内容都经过深思熟虑的设计,同时语言生动幽默,行文流畅自如。",
"score": 0.999
},
{
"title": "Rust 程序设计语言 - Rust 程序设计语言 中文版",
"url": "https://kaisery.github.io/trpl-zh-cn/",
"content": "《Rust 程序设计语言》中文翻译,官方 The Rust Programming Language 的中文版本。",
"score": 0.95
}
]
}
}
调用示例
curl "https://api.tinyaii.cn/v1/web/search?query=<query>" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/web/search?query=<query>", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/web/search",
params={"query": "<query>"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。