API / SDK / developer guide
Prediction
| 目標讀者 TA | 應用工程師 |
|---|---|
| 官方文件能力 | 以選定模型處理影像或影片。 |
| 輸入 → 輸出 | 影像／影格 → 任務對應結果 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 固定權重與前處理，結果隨任務不同。 |
| 本站建議驗證 | 核對原圖座標映射。 |
電腦視覺 · SDK
Ultralytics YOLO
Ultralytics
使用 Ultralytics 模型工具執行物件偵測與分割。
ULTRALYTICS YOLO / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 起源 | Ultralytics 以 Glenn Jocher 推動易用電腦視覺的工作為起點。 |
|---|---|
| 使命 | 公司強調面向開發者與企業的易用開源 AI。 |
| 公司資訊 | About 包含團隊、價值、產品與商業授權入口。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方專案與開發來源；沒有呼叫供應商 API。下方預期輸出是本站示意契約，不是實測結果。
十項技術入口比較
依任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · PredictionAPI / SDK / developer guide | 以選定模型處理影像或影片。應用工程師 |
| 02 · TrainingAPI / SDK / developer guide | 使用資料集訓練模型權重。ML 工程師 |
| 03 · ValidationAPI / SDK / developer guide | 使用標註資料評估模型。ML／QA |
| 04 · Model exportAPI / SDK / developer guide | 將模型產物匯出至目標格式。邊緣部署團隊 |
| 05 · Video trackingAPI / SDK / developer guide | 跨影格關聯偵測結果。視訊應用團隊 |
| 06 · Benchmark modeAPI / SDK / developer guide | 在選定裝置比較執行格式。效能工程師 |
| 07 · Object detectionAPI / SDK / developer guide | 以邊界框偵測實例。巡檢工程師 |
| 08 · Instance segmentationAPI / SDK / developer guide | 產生實例遮罩。量測／視覺團隊 |
| 09 · Pose estimationAPI / SDK / developer guide | 估計設定的關鍵點。動作應用團隊 |
| 10 · Oriented boxesAPI / SDK / developer guide | 以旋轉框定位物件。航拍／零件視覺團隊 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Training
| 目標讀者 TA | ML 工程師 |
|---|---|
| 官方文件能力 | 使用資料集訓練模型權重。 |
| 輸入 → 輸出 | 資料集＋設定 → 權重與紀錄 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 訓練完成不代表泛化能力已驗證。 |
| 本站建議驗證 | 評估影像不可混入訓練。 |
API / SDK / developer guide
Validation
| 目標讀者 TA | ML／QA |
|---|---|
| 官方文件能力 | 使用標註資料評估模型。 |
| 輸入 → 輸出 | 權重＋獨立資料 → 指標 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 整體指標可能掩蓋稀有缺陷失敗。 |
| 本站建議驗證 | 呈現各類召回率與誤報。 |
API / SDK / developer guide
Model export
| 目標讀者 TA | 邊緣部署團隊 |
|---|---|
| 官方文件能力 | 將模型產物匯出至目標格式。 |
| 輸入 → 輸出 | 權重 → 匯出產物 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 匯出成功不保證目標環境支援。 |
| 本站建議驗證 | 比對目標輸出與原始模型。 |
API / SDK / developer guide
Video tracking
| 目標讀者 TA | 視訊應用團隊 |
|---|---|
| 官方文件能力 | 跨影格關聯偵測結果。 |
| 輸入 → 輸出 | 影格 → 框線與追蹤 ID |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 追蹤 ID 是暫時軌跡識別，不是人員身分。 |
| 本站建議驗證 | 測試遮擋、重新進入與 ID 切換。 |
API / SDK / developer guide
Benchmark mode
| 目標讀者 TA | 效能工程師 |
|---|---|
| 官方文件能力 | 在選定裝置比較執行格式。 |
| 輸入 → 輸出 | 模型＋硬體 → 時間與指標報告 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 公開評測不等於自有硬體量測。 |
| 本站建議驗證 | 記錄暖機、精度與批次大小。 |
API / SDK / developer guide
Object detection
| 目標讀者 TA | 巡檢工程師 |
|---|---|
| 官方文件能力 | 以邊界框偵測實例。 |
| 輸入 → 輸出 | 影像 → 類別、分數與框 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 預設類別可能不含所需缺陷。 |
| 本站建議驗證 | 用代表性零件確認類別對照。 |
API / SDK / developer guide
Instance segmentation
| 目標讀者 TA | 量測／視覺團隊 |
|---|---|
| 官方文件能力 | 產生實例遮罩。 |
| 輸入 → 輸出 | 影像 → 遮罩與實例標籤 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 像素遮罩不是校正後實體量測。 |
| 本站建議驗證 | 與參考遮罩比對邊界。 |
API / SDK / developer guide
Pose estimation
| 目標讀者 TA | 動作應用團隊 |
|---|---|
| 官方文件能力 | 估計設定的關鍵點。 |
| 輸入 → 輸出 | 影像 → 關鍵點座標 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 骨架語意依模型而定。 |
| 本站建議驗證 | 檢查缺失點與可見條件。 |
API / SDK / developer guide
Oriented boxes
| 目標讀者 TA | 航拍／零件視覺團隊 |
|---|---|
| 官方文件能力 | 以旋轉框定位物件。 |
| 輸入 → 輸出 | 影像 → 方向邊界幾何 |
| 執行環境 | 本地應用／固定函式庫與模型 |
| 本站選型評估 | 角度慣例須與下游轉接器一致。 |
| 本站建議驗證 | 測試接近角度循環邊界的旋轉樣本。 |
Official documentation overview
| TA | 選擇支援技術路徑的工程師與產品負責人。 |
|---|---|
| 本站驗證建議 | 安排實作前先選定操作、支援版本與執行環境。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
模型與 SDK 評估；部署前需選定確切權重、依賴與適用授權。本頁不執行推論。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
偵測到物件
| 輸入 | 影像及選定偵測權重 |
|---|---|
| 預期結果 | ok，含類別、分數與 xyxy 像素座標 |
| 驗收條件 | 框在影像範圍內，類別對應正確 |
無偵測
| 輸入 | 有效影像，未達選定門檻 |
|---|---|
| 預期結果 | ok；detections=[] |
| 驗收條件 | 不得虛構框線 |
權重不可用
| 輸入 | 缺少或不相容模型產物 |
|---|---|
| 預期結果 | error；model_unavailable |
| 驗收條件 | 不產生虛構預測 |
匯出不一致
| 輸入 | 原始與匯出模型處理同樣本 |
|---|---|
| 預期結果 | 回傳差異比較，不自動通過 |
| 驗收條件 | 符合約定精度差異後才部署 |
將預期結果對應至你的應用
先審閱下方情境，再將實際 SDK 回應對應至此內部契約。此處不含憑證、API 呼叫或真實輸出，示意資料須在自行串接測試後替換。
預期輸出 JSON — 示意，非實測 · UltralyticsYOLO-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "Ultralytics YOLO",
"status": "ok",
"input_id": "sample-001",
"data": {
"detections": [
{
"class_id": 0,
"label": "sample-part",
"score": 0.86,
"xyxy_pixels": [
20,
30,
120,
160
]
}
]
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果狀態 | ok 表示所選操作回傳有效結構；有效空結果與 error 不同。未完成工作保持 pending 直到終態。API 成功不代表現實判斷必然正確。 |
|---|---|
| 可重現性 | 記錄輸入識別、函式庫／模型版本、設定、執行環境及座標／分數慣例。範例數值為示意。 |
| 建議驗收 | 使用授權代表樣本，加上空結果、格式錯誤與環境不可用案例。測試前先約定品質與延遲目標；不宣稱已量測準確率、成本或速度。 |
| 操作範圍 | 模型與 SDK 評估；部署前需選定確切權重、依賴與適用授權。本頁不執行推論。 |
可一併評估的路線： Roboflow
開發評估
瑕疵候選偵測器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 少量經授權影像、任務定義與參考標註。
- 原型交付規劃
- 可審核的影像引用、標籤或標註狀態；保留原始檔案。
- 驗收條件
- 用已標註樣本比對支援的操作；錯誤與缺漏結果分開呈現。
- 依賴條件
- 資料集存取、影像使用權與支援的模型或標註專案。
串接前置條件
商用散布前須核對選定程式碼與模型的授權。
開發順序
- 確認 Ultralytics YOLO 的存取、授權與支援版本。
- 準備上述樣本，針對「瑕疵候選偵測器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。