开始之前
统一请求地址为 https://api.zleap.com。准备一个 Zleap 账户和已启用的 API Key，即可在应用中发起请求，或使用工作台在线测试。
先用网页搜索完成首次调用，再按需要接入决策模型、抓取或文件处理。
1. 创建 API Key
前往 API Key 管理，创建用于开发环境的 Key，并授权“网页搜索”。Key 只放在服务端或本地环境变量中，不能放入公开网页、仓库或分享给 AI 的文本。
2. 配置运行环境
cURL 示例可直接在终端执行。Python 示例需要 Python 3 和 requests；JavaScript 示例使用支持 fetch 的 Node.js。文件上传示例还需要支持 openAsBlob 的 Node.js 版本。
bash
export ZLEAP_API_KEY="替换为你的 API Key"
# 使用 Python 时先安装依赖
python -m pip install requests
Windows PowerShell 使用 $env:ZLEAP_API_KEY="你的 API Key"。文档中的 Key 始终是占位值。
3. 发送第一条请求
bash
curl --fail-with-body https://api.zleap.com/v1/tools/search \
-H "Authorization: Bearer $ZLEAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"智能体开发指南","count":3,"need_content":false}'
4. 读取响应
请求成功后返回 HTTP 200，从 results 数组读取搜索结果。响应格式如下。
json
{
"results": [
{
"title": "智能体开发指南",
"url": "https://example.com/guide",
"summary": "智能体开发的接口与接入指南。",
"content": ""
}
]
}
读取 results，从每项取出 title、url 和 summary。results: [] 表示没有结果；非 2xx 响应应按错误处理检查，不能当作空结果。