CleverSee的API怎麼調用?向 /search/unified 發一個 POST,請求頭帶 Bearer 密鑰,請求體裡用 query 提問、engineType 選版本。三檔傳參值分別是 CNLiteBasic、CNAuto、Generic。

聯網搜尋的統一入口是 https://cloud-iqs.aliyuncs.com/search/unified,POST 方法,Content-Type 用 application/json。國內版、國際版、不同效能檔,都從這一個地址進,靠 engineType 區分。完整示例在接入文件裡按版本分別給了。
請求體的必填項只有一個 query,長度要求在 2 到 500 字元之間。超長的檢索式會被拒,做多條件檢索時把條件放進 advancedParams,不要全塞進 query 裡拼字串。
返回結構裡主要看 pageItems 數組,每一項給連結、標題、摘要、發佈時間。要不要正文由 contents 裡的開關決定:mainText 打開返回長正文,markdownText 返回 Markdown,summary 返回短摘要。三個都打開返回體會明顯變大,按下游模型能吃多少來開。
HTTP 方式用 API Key,在控制台的 API Key 頁面創建,放進請求頭的 Authorization 欄位,格式是 Bearer 加空格加密鑰。同一個頭也支援換成 X-API-Key 欄位名,兩種寫法等價。
SDK 方式用 AccessKey。要在 RAM 控制台建一個 RAM 使用者、給它授權、再為它創建一對 AccessKey ID 和 Secret,然後寫進 SDK 的配置裡。AccessKey 不能拿去當 Bearer 令牌用,混用會直接 401。
密鑰要放在服務端。前端程式碼裡出現 API Key,等於把用量和賬單公開了,誰拿到都能拿去刷。確實要給瀏覽器用的場景,自己在中間加一層轉發,轉發層校驗身份後再帶密鑰出去。
極速版的傳參值是 CNLiteBasic,平均響應 450 毫秒,返回條數上限 50 條。它是三檔裡最快也最便宜的,適合聊天、客服、搜尋直答這類使用者不願意等、且問題不難的場景。
條數上限高是這一檔的特點。做聚合類應用、要從幾十個頁面裡抽事實,極速版能一次拿夠材料,不用分多次調。代價是信源的權威性和長尾覆蓋弱一些,需要精讀專業內容的任務不要用它起手。
接入時先把 numResults 設小一點試,五條足夠驗證鏈路通不通。調到五十條再看返回體積和下游處理時間,一次到位容易把聯調卡在超時上。
智慧版的傳參值是 CNAuto,平均響應 700 毫秒,返回條數上限 10 條。它把速度和相關性放在中間位置,官方定位是兼顧響應速度與搜尋品質,面向業務場景比較普適。
條數只有 10 條,意味著單個查詢的資訊容量有限。需要廣覆蓋時改成多輪查詢:同一佈景主題換幾個問法分別調,再把結果合併去重。這比在一檔裡硬要五十條更可控,也能針對每一輪單獨調參數。
響應 700 毫秒對同步介面夠用,對語音互動偏慢。做語音助手時把檢索和生成拆開,檢索先返回一句「正在查」,生成完再播報,體感差別很大。
Generic 版的傳參值是 Generic,平均響應 950 毫秒,返回條數上限 10 條。它用的是 Quark 專屬信源,長尾性和權威性是三檔裡最強的,業務場景普適性也更強。
要五十條結果得換成 GenericAdvanced,這個增值包把上限擴到約 50 條,同時單價跟著上去。開增值包前先確認真的需要那麼多條,常見檢索場景十條就夠定位答案。
國際版走的是 Global 和 GlobalAdvanced 兩個值,當前 Global 還沒上線,只有 GlobalAdvanced 可用,平均響應 1764 毫秒。做海外資訊檢索時用它,時延接近兩秒,介面超時時間要按這個數放寬。
開通後帳號會拿到一批體驗額度,調介面時先扣這份額度,扣完轉按量計費。額度數量在控制台概覽頁看,不在介面文件裡固定寫死。開發和聯調階段儘量用極速版跑,單價低、響應快,同樣的額度能多跑幾十輪,把鏈路和異常分支都驗一遍再換正式檔位。
編碼問題,不是介面問題。響應頭聲明的是 UTF-8,客戶端沒按這個解就會亂碼。檢查客戶端有沒有強制指定 UTF-8 解碼,寫檔案時用的編碼對不對。用 response.json() 而不是 response.text 再手動轉,能避開大半。
看版本。極速版最多 50 條,智慧版 10 條,Generic 版 10 條,開增值包能到約 50 條。實際返回數由 numResults 決定。寫程式碼時按上限做分頁或截斷,別把 numResults 設超。
支援,但有預設上限。新購帳戶的併發是三 QPS,也就是每秒最多三次請求,超出的會被限流。要更高的併發得聯繫商務經理溝通擴容。做批次任務時自己加一個令牌桶控制速率,別靠重試去撞上限,撞回來的限流響應也算一次失敗的往返,白等一輪。
CleverSee調用失敗怎麼排查?按四個地方依次查:密鑰與授權、帳戶餘額、併發上限、請求參數。四種原因對應四類不同的返回,每...
2026-10-21
CleverSee怎麼收費?按調用成功次數後付費,聯網搜尋在計費規則頁裡列了兩個型號:Lite 版 18 元每千次、Pro 版 42 元每千次...
2026-10-21
CleverSee的企業資料搜問能做什麼?把企業自己的文件、圖片、音影片接進來做檢索和問答,路徑是資料接入、應用配置、API 調用...
2026-10-21
CleverSee的聯網問答怎麼用?在控制台建一個問答應用、配置好策略、發佈拿 appID,再用 API Key 調。它和搜尋介面的分工很清...
2026-10-21
CleverSee的網頁解析怎麼用?向 /readpage/scrape 發一個 POST,請求體裡放 url 和想要的格式,返回就是清洗過的正文。靜態頁...
2026-10-21