首頁 > AI工具 > CleverSee的API怎麼調用?密鑰和三種版本傳參

CleverSee的API怎麼調用?密鑰和三種版本傳參

更新時間:2026-10-22 00:31:58 發布時間:5小時前 閱讀:12 views次

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

CleverSee的API怎麼調用?密鑰和三種版本傳參

CleverSee的搜尋介面只有一個地址

聯網搜尋的統一入口是 https://cloud-iqs.aliyuncs.com/search/unified,POST 方法,Content-Type 用 application/json。國內版、國際版、不同效能檔,都從這一個地址進,靠 engineType 區分。完整示例在接入文件裡按版本分別給了。

請求體的必填項只有一個 query,長度要求在 2 到 500 字元之間。超長的檢索式會被拒,做多條件檢索時把條件放進 advancedParams,不要全塞進 query 裡拼字串。

返回結構裡主要看 pageItems 數組,每一項給連結、標題、摘要、發佈時間。要不要正文由 contents 裡的開關決定:mainText 打開返回長正文,markdownText 返回 Markdown,summary 返回短摘要。三個都打開返回體會明顯變大,按下游模型能吃多少來開。

CleverSee的密鑰有兩種來源

HTTP 方式用 API Key,在控制台的 API Key 頁面創建,放進請求頭的 Authorization 欄位,格式是 Bearer 加空格加密鑰。同一個頭也支援換成 X-API-Key 欄位名,兩種寫法等價。

SDK 方式用 AccessKey。要在 RAM 控制台建一個 RAM 使用者、給它授權、再為它創建一對 AccessKey ID 和 Secret,然後寫進 SDK 的配置裡。AccessKey 不能拿去當 Bearer 令牌用,混用會直接 401。

密鑰要放在服務端。前端程式碼裡出現 API Key,等於把用量和賬單公開了,誰拿到都能拿去刷。確實要給瀏覽器用的場景,自己在中間加一層轉發,轉發層校驗身份後再帶密鑰出去。

CleverSee的極速版適合日常問答

極速版的傳參值是 CNLiteBasic,平均響應 450 毫秒,返回條數上限 50 條。它是三檔裡最快也最便宜的,適合聊天、客服、搜尋直答這類使用者不願意等、且問題不難的場景。

條數上限高是這一檔的特點。做聚合類應用、要從幾十個頁面裡抽事實,極速版能一次拿夠材料,不用分多次調。代價是信源的權威性和長尾覆蓋弱一些,需要精讀專業內容的任務不要用它起手。

接入時先把 numResults 設小一點試,五條足夠驗證鏈路通不通。調到五十條再看返回體積和下游處理時間,一次到位容易把聯調卡在超時上。

CleverSee的智慧版把條數壓到十條

智慧版的傳參值是 CNAuto,平均響應 700 毫秒,返回條數上限 10 條。它把速度和相關性放在中間位置,官方定位是兼顧響應速度與搜尋品質,面向業務場景比較普適。

條數只有 10 條,意味著單個查詢的資訊容量有限。需要廣覆蓋時改成多輪查詢:同一佈景主題換幾個問法分別調,再把結果合併去重。這比在一檔裡硬要五十條更可控,也能針對每一輪單獨調參數。

響應 700 毫秒對同步介面夠用,對語音互動偏慢。做語音助手時把檢索和生成拆開,檢索先返回一句「正在查」,生成完再播報,體感差別很大。

CleverSee的Generic版走專屬信源

Generic 版的傳參值是 Generic,平均響應 950 毫秒,返回條數上限 10 條。它用的是 Quark 專屬信源,長尾性和權威性是三檔裡最強的,業務場景普適性也更強。

要五十條結果得換成 GenericAdvanced,這個增值包把上限擴到約 50 條,同時單價跟著上去。開增值包前先確認真的需要那麼多條,常見檢索場景十條就夠定位答案。

國際版走的是 Global 和 GlobalAdvanced 兩個值,當前 Global 還沒上線,只有 GlobalAdvanced 可用,平均響應 1764 毫秒。做海外資訊檢索時用它,時延接近兩秒,介面超時時間要按這個數放寬。

常見問題

CleverSee的API有免費調用額度嗎

開通後帳號會拿到一批體驗額度,調介面時先扣這份額度,扣完轉按量計費。額度數量在控制台概覽頁看,不在介面文件裡固定寫死。開發和聯調階段儘量用極速版跑,單價低、響應快,同樣的額度能多跑幾十輪,把鏈路和異常分支都驗一遍再換正式檔位。

CleverSee返回中文亂碼怎麼辦

編碼問題,不是介面問題。響應頭聲明的是 UTF-8,客戶端沒按這個解就會亂碼。檢查客戶端有沒有強制指定 UTF-8 解碼,寫檔案時用的編碼對不對。用 response.json() 而不是 response.text 再手動轉,能避開大半。

CleverSee一次能返回多少條結果

看版本。極速版最多 50 條,智慧版 10 條,Generic 版 10 條,開增值包能到約 50 條。實際返回數由 numResults 決定。寫程式碼時按上限做分頁或截斷,別把 numResults 設超。

CleverSee的介面支援併發調用嗎

支援,但有預設上限。新購帳戶的併發是三 QPS,也就是每秒最多三次請求,超出的會被限流。要更高的併發得聯繫商務經理溝通擴容。做批次任務時自己加一個令牌桶控制速率,別靠重試去撞上限,撞回來的限流響應也算一次失敗的往返,白等一輪。