連線推論 API

向服務傳送一個樣本,並告訴 Knotest 如何讀取回應。

模型透過 HTTP 服務提供預測時,使用 API Profile。它記錄如何傳送樣本,以及回應中的哪些欄位是預測結果。

開始前準備

準備介面地址、認證要求,以及請求和回應示例。服務應返回與你要評估的任務相符的預測。先選擇一個允許傳送給該服務的小樣本。

配置並嘗試請求

  1. 開啟 API Profiles → Connect API。填寫名稱,先選擇任務。
  2. 填寫請求地址和方法。也可以透過 cURL 或位址列匯入 cURL 命令。
  3. 按服務要求配置 Params、Headers 和 Auth。在 Auth 中填寫憑據。
  4. 開啟 Body,選擇服務要求的 JSON、表單資料或原始圖片。編輯 JSON 時,輸入 {{ 可選擇樣本變數,例如圖片的 Base64 資料。
  5. 用 Choose a sample 選擇資料集和樣本,再選擇 Send。
  6. 檢查回應。如果服務返回錯誤,先修正地址、認證或請求內容。

將回應對映為預測

在 Map to predictions 中,透過 Pick in response 從成功的回應裡選擇欄位,也可以直接編輯欄位路徑。

物件偵測需要確定偵測結果列表、類別、置信度(如有)和框座標。讓 Box format 和 Units 與回應一致,例如畫素座標與 0–1 座標需要不同的設定。如果類別是數字 ID,還要按正確順序提供對應的名稱。

選擇 Verify 檢查對映,閱讀結果後 Save。生成預測時,選擇儲存的 API Profile 作為推論來源。

配置中的 API 示例。

操作示範: 認識 API 工作臺檢視請求和對映控制項。example.com 地址只是佔位示例,影片中沒有傳送請求。Knotest 1.2.19 · 無旁白示範 · 可全螢幕查看細節

憑據儲存在這臺電腦的憑據儲存中。將專案移到另一臺電腦後,需要重新配置憑據並驗證連線。

Send 和預測生成會將所選樣本傳送到你的服務。使用私有資料前,先檢查目標地址。