快速开始

只需 3 步，即可为你的 AI 应用接入联网搜索能力。

Step 1：获取 API Key

访问梓享 AI 搜索控制台
注册/登录账号
在控制台创建并复制 API Key

注意

安全提示请妥善保管你的 API Key，不要在客户端代码或公开仓库中暴露

Step 2：发起首次搜索

Python

import requests

url = "https://search.aiserver.cloud/v1/api"
headers = {
    "Authorization": "Bearer Your-API-KEY",
    "Content-Type": "application/json"
}
data = {
    "engine": "china",
    "query": "人工智能发展趋势",
    "max_results": 10
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript

const response = await fetch("https://search.aiserver.cloud/v1/api", {
  method: "POST",
  headers: {
    Authorization: "Bearer Your-API-KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    engine: "china",
    query: "人工智能发展趋势",
    max_results: 10,
  }),
});

const data = await response.json();
console.log(data);

cURL

curl --location 'https://search.aiserver.cloud/v1/api' \
  --header 'Authorization: Bearer Your-API-KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "engine": "china",
    "query": "人工智能发展趋势",
    "max_results": 10
  }'

PHP

<?php
$url = "https://search.aiserver.cloud/v1/api";
$data = [
    "engine" => "china",
    "query" => "人工智能发展趋势",
    "max_results" => 10
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer Your-API-KEY",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://search.aiserver.cloud/v1/api"
    data := map[string]interface{}{
        "engine":      "china",
        "query":       "人工智能发展趋势",
        "max_results": 10,
    }
    jsonData, _ := json.Marshal(data)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer Your-API-KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    fmt.Println(resp.Status)
}

Step 3：解析响应

成功响应示例：

{
  "code": 0,
  "msg": "",
  "engine": "china",
  "balance": {
    "times": { "china": 990, "global": 1000 },
    "amount": 100.0
  },
  "log_id": "LOG202512272011x5oSe7",
  "data": {
    "images": [],
    "results": [
      {
        "title": "人工智能十大发展趋势",
        "url": "https://example.com/ai-trends-2024",
        "content": "，人工智能将在多个领域迎来突破性进展..."
      }
    ]
  }
}

响应字段说明

字段	说明
`code`	状态码，`0` 表示成功
`engine`	本次使用的引擎
`balance.times`	剩余套餐次数
`balance.amount`	预充余额
`data.results`	搜索结果列表
`data.images`	相关图片列表

切换引擎

只需修改 engine 参数即可切换到全球引擎：

{
  "engine": "global",
  "query": "What is AI?",
  "max_results": 5
}

引擎	说明
`engine=china`	中文网页精准搜索，覆盖中国区内容
`engine=global`	全球网页搜索，支持多语言

常用参数

参数	类型	说明
`engine`	string	`china` 或 `global`，默认 `china`
`query`	string	搜索关键词，支持自然语言
`max_results`	number	返回条数，1-20
`time_filter`	string	时间过滤：`day`/`week`/`month`/`year`
`include_domains`	array	指定搜索的网站范围
`exclude_domains`	array	排除搜索的网站范围

下一步

文档	说明
Web Search API	完整参数与返回字段说明
产品介绍	深入了解双引擎架构
定价	查看套餐价格与计费规则
控制台	管理 API Key、查看用量

提示

建议在开发环境使用小额测试，验证集成效果后再投入生产。