{"reference_analysis":{"checked_at":"2026-10-08","provider":"Label Studio / HumanSignal","about_url":"https://humansignal.com/about/","source_access":{"en":"Official documentation read on 2026-10-08. No API was called; proposed checks and examples are our analysis.","zh-TW":"於 2026-10-08 讀取官方文件。未呼叫 API；建議檢查與範例為本站分析。"},"selection_basis":{"en":"Ten documented interfaces, operations or tools selected by integration task; not an official ranking or ten separate SDKs.","zh-TW":"依整合任務挑選十個文件記載的介面、操作或工具；不是官方排名或十個獨立 SDK。"},"about":[{"label":{"en":"Company","zh-TW":"公司"},"value":{"en":"HumanSignal is the company behind the open-source Label Studio project; its About page dates the company to 2019.","zh-TW":"HumanSignal 是開源 Label Studio 背後公司，About 記載公司於 2019 年成立。"}},{"label":{"en":"Purpose","zh-TW":"目的"},"value":{"en":"Its stated approach puts people, data and domain expertise into ML/AI workflows.","zh-TW":"其自述方向將人、資料與領域專業納入 ML／AI 工作流程。"}},{"label":{"en":"Product context","zh-TW":"產品脈絡"},"value":{"en":"The company offers Label Studio Enterprise alongside the community project, with additional workflow and governance capabilities.","zh-TW":"公司在社群專案之外提供 Label Studio Enterprise，包含額外流程與治理能力。"}},{"label":{"en":"Our fit assessment","zh-TW":"本站適配評估"},"value":{"en":"A candidate for multimodal labeling and human review; treat edition selection, model serving and annotation acceptance as separate decisions.","zh-TW":"適合評估多模態標註及人工覆核；版本選擇、模型服務與標註驗收需分別決策。"}}],"items":[{"id":"sdk","name":"Python SDK","kind":"SDK","url":"https://api.labelstud.io/api-reference/introduction/getting-started","audience":{"en":"Python / data platform","zh-TW":"Python／資料平台"},"capability":{"en":"Use typed SDK resources to access Label Studio from scripts.","zh-TW":"以 SDK 資源從程式存取 Label Studio。"},"io":{"en":"Server URL and access token → resource operations","zh-TW":"伺服器網址及 access token → 資源操作"},"runtime":{"en":"Python client and selected Label Studio deployment.","zh-TW":"Python client 與選定 Label Studio 部署。"},"constraint":{"en":"SDK generations and token types differ; some endpoints require paid editions.","zh-TW":"SDK 世代與 token 類型不同，部分端點需付費版本。"},"validation":{"en":"Pin SDK/server versions; verify identity and configure timeouts before writes.","zh-TW":"固定 SDK／伺服器版本，寫入前確認身分並設定逾時。"}},{"id":"projects","name":"Project creation","kind":"SDK operation","url":"https://api.labelstud.io/tutorials/tutorials/create-a-project","audience":{"en":"Annotation platform / project owner","zh-TW":"標註平台／專案負責人"},"capability":{"en":"Create a project with a title and labeling configuration.","zh-TW":"以標題與標註設定建立專案。"},"io":{"en":"Project specification → project ID","zh-TW":"專案規格 → 專案 ID"},"runtime":{"en":"Label Studio server.","zh-TW":"Label Studio 伺服器。"},"constraint":{"en":"A repeated create request can create another project; retain returned identity.","zh-TW":"重複建立請求可能產生另一個專案，需保留回傳識別。"},"validation":{"en":"Retrieve the intended project and compare its configuration before importing tasks.","zh-TW":"匯入任務前取得目標專案並比對設定。"}},{"id":"config","name":"Labeling configuration","kind":"Interface schema","url":"https://labelstud.io/guide/setup","audience":{"en":"UX / annotation domain expert","zh-TW":"UX／標註領域專家"},"capability":{"en":"Define labeling interfaces with XML tags and connected controls.","zh-TW":"以 XML tags 及連動控制項定義標註介面。"},"io":{"en":"Object/control tags → labeling UI","zh-TW":"物件／控制 tags → 標註介面"},"runtime":{"en":"Rendered labeling frontend with project configuration.","zh-TW":"依專案設定呈現的標註前端。"},"constraint":{"en":"Renaming tags can break existing prediction/result mappings.","zh-TW":"更改 tag 名稱可能破壞既有預測／結果對應。"},"validation":{"en":"Test one fixture per label and validate from_name/to_name bindings.","zh-TW":"每種標籤測一筆，驗證 from_name／to_name 綁定。"}},{"id":"tasks","name":"Task import","kind":"Data ingestion","url":"https://labelstud.io/guide/tasks","audience":{"en":"Data engineer / annotation lead","zh-TW":"資料工程／標註主管"},"capability":{"en":"Import task data for configured labeling projects.","zh-TW":"匯入設定標註專案的任務資料。"},"io":{"en":"Task JSON or supported data files → labeling tasks","zh-TW":"任務 JSON 或支援檔案 → 標註任務"},"runtime":{"en":"Server import plus accessible media storage.","zh-TW":"伺服器匯入與可存取媒體儲存。"},"constraint":{"en":"Imported metadata is not proof that annotators can load the media.","zh-TW":"匯入中繼資料不代表標註者可載入媒體。"},"validation":{"en":"Reconcile external sample IDs, task counts and browser media access.","zh-TW":"核對外部樣本 ID、任務數及瀏覽器媒體存取。"}},{"id":"predictions","name":"Prediction import","kind":"Pre-annotation interface","url":"https://labelstud.io/guide/predictions","audience":{"en":"ML engineer / human-in-the-loop team","zh-TW":"ML 工程師／人工覆核團隊"},"capability":{"en":"Load model predictions as pre-annotations tied to the labeling configuration.","zh-TW":"載入對應標註設定的模型預測作為預標註。"},"io":{"en":"Model results and version → proposed regions/labels","zh-TW":"模型結果及版本 → 建議區域／標籤"},"runtime":{"en":"Prediction generation is external; Label Studio displays proposals.","zh-TW":"預測於外部產生，Label Studio 呈現建議。"},"constraint":{"en":"Predictions are not automatically human-approved ground truth.","zh-TW":"預測不自動成為人工認可的真值。"},"validation":{"en":"Preserve model version and compare prediction region IDs with reviewed annotations.","zh-TW":"保留模型版本，比較預測區域 ID 與覆核標註。"}},{"id":"annotation","name":"Annotation creation","kind":"REST operation","url":"https://api.labelstud.io/api-reference/api-reference/annotations/create","audience":{"en":"Backend / annotation migration","zh-TW":"後端／標註遷移"},"capability":{"en":"Attach annotation results to a task.","zh-TW":"將標註結果附加至任務。"},"io":{"en":"Task ID and configured results → annotation record","zh-TW":"任務 ID 及相容結果 → 標註紀錄"},"runtime":{"en":"Label Studio annotation API.","zh-TW":"Label Studio 標註 API。"},"constraint":{"en":"Result structure depends on controls; cancelled/skipped annotations are not negative examples.","zh-TW":"結果結構依控制項而異；取消或略過不是無目標樣本。"},"validation":{"en":"Validate schema, ownership and cancelled flags before training export.","zh-TW":"訓練匯出前驗證 schema、所屬及取消旗標。"}},{"id":"export","name":"Annotation export and snapshots","kind":"Dataset delivery","url":"https://labelstud.io/guide/export","audience":{"en":"ML training / dataset release","zh-TW":"ML 訓練／資料集發布"},"capability":{"en":"Export annotations or create and download a snapshot.","zh-TW":"匯出標註或建立並下載快照。"},"io":{"en":"Project export selection → dataset file","zh-TW":"專案匯出選擇 → 資料集檔案"},"runtime":{"en":"Server export and chosen downstream format.","zh-TW":"伺服器匯出與選定後續格式。"},"constraint":{"en":"Image JSON boxes use percentages; formats and editions differ in included tasks and background processing.","zh-TW":"影像 JSON 框線採百分比；格式及版本在納入任務與背景處理上不同。"},"validation":{"en":"Convert a known rectangle and reconcile exported, skipped and unannotated tasks separately.","zh-TW":"轉換已知矩形，分別核對匯出、略過及未標註任務。"}},{"id":"ml-backend","name":"Custom ML backend","kind":"Model adapter","url":"https://labelstud.io/guide/ml_create","audience":{"en":"ML / serving engineer","zh-TW":"ML／模型服務工程師"},"capability":{"en":"Implement predict and optional fit logic for model-assisted labeling.","zh-TW":"實作 predict 與選填 fit 邏輯，支援模型輔助標註。"},"io":{"en":"Tasks and interaction context → predictions","zh-TW":"任務及互動脈絡 → 預測"},"runtime":{"en":"Separately deployed ML backend connected to Label Studio.","zh-TW":"獨立部署、連接 Label Studio 的 ML 後端。"},"constraint":{"en":"Connecting the backend does not supply trained weights or guarantee prediction schema compatibility.","zh-TW":"連接後端不代表提供訓練權重或保證預測 schema 相容。"},"validation":{"en":"Test health, one task, malformed output and backend unavailability.","zh-TW":"測試健康狀態、單筆任務、格式錯誤及後端離線。"}},{"id":"storage","name":"Source and target storage","kind":"Storage integration","url":"https://labelstud.io/guide/storage","audience":{"en":"Infrastructure / data owner","zh-TW":"基礎設施／資料負責人"},"capability":{"en":"Connect source media and target annotation storage per project.","zh-TW":"依專案連接來源媒體與目標標註儲存。"},"io":{"en":"Storage configuration and sync → task references or exported annotations","zh-TW":"儲存設定與同步 → 任務引用或匯出標註"},"runtime":{"en":"Label Studio, object storage and annotator browsers.","zh-TW":"Label Studio、物件儲存及標註者瀏覽器。"},"constraint":{"en":"Source sync is not automatic bidirectional consistency; browser access also needs validation.","zh-TW":"來源同步不等於自動雙向一致，瀏覽器存取也需驗證。"},"validation":{"en":"Test a newly added file, expired presigned URL and output write permission.","zh-TW":"測試新增檔案、過期預簽網址與輸出寫入權限。"}},{"id":"webhooks","name":"Webhooks","kind":"Event integration","url":"https://labelstud.io/guide/webhooks","audience":{"en":"Pipeline / backend engineer","zh-TW":"管線／後端工程師"},"capability":{"en":"Send selected project or annotation events to an HTTP receiver.","zh-TW":"將指定專案或標註事件傳至 HTTP 接收器。"},"io":{"en":"Labeling event → event payload","zh-TW":"標註事件 → 事件資料"},"runtime":{"en":"Server-to-server receiver with configured authentication headers.","zh-TW":"設定認證 header 的伺服器間接收器。"},"constraint":{"en":"The guide states failed webhook connections are not retried; design reconciliation.","zh-TW":"指南指出失敗連線不會重試，需設計補核流程。"},"validation":{"en":"Acknowledge quickly, queue processing and compare missed events with authoritative task records.","zh-TW":"快速回應並佇列處理，以正式任務紀錄核對遺漏事件。"}}],"supporting_references":[{"id":"tokens","name":"Access tokens","url":"https://labelstud.io/guide/access_tokens","audience":{"en":"Backend owner: token type, refresh and deployment policy.","zh-TW":"後端負責人：token 類型、更新與部署政策。"},"validation":{"en":"Match the authentication scheme to the token type; do not paste tokens into examples or logs.","zh-TW":"認證方式必須符合 token 類型，不將 token 貼入範例或日誌。"}},{"id":"workflow","name":"ML pipeline overview","url":"https://labelstud.io/guide/ml","audience":{"en":"Technical PM: separate labeling, predictions and model execution.","zh-TW":"技術 PM：區分標註、預測與模型執行。"},"validation":{"en":"Define who supplies the model and where media is processed before enabling automation.","zh-TW":"開啟自動化前定義模型提供者與媒體處理位置。"}},{"id":"primary-docs","name":"Primary developer documentation","url":"https://labelstud.io/guide/api","audience":{"en":"Engineers choosing the supported API and installed version.","zh-TW":"選擇支援 API 與安裝版本的工程師。"},"validation":{"en":"Match the operation and version to the specific references above before implementation. The illustrative output is an internal application contract.","zh-TW":"實作前將操作與版本對應至上述具體文件；示意輸出是內部應用契約。"}}]},"content_coverage":{"reference_guide":true,"developer_starter":false,"expected_results":true,"integration_test":"not-run","updated_at":"2026-10-08"},"developer_starter":{"version":"1.0.0","verification":"illustrative-contract-only;live-provider-not-run","filename":"LabelStudioAPI-expected-results.json","format":"json-example","scope":{"en":"Illustrative reviewed-image annotation contract, with explicit percentage-to-pixel conversion.","zh-TW":"已覆核影像標註契約示意，明確顯示百分比轉像素。"},"setup":{"en":"Agree XML control names, label schema and review policy first. The following JSON is an invented internal example, not a native API request/response or a completed annotation.","zh-TW":"先約定 XML 控制名稱、標籤 schema 與覆核政策。以下 JSON 是自訂內部示例，不是原生 API 請求／回應或完成的標註。"},"code":"{\n  \"schema_version\": \"1.0.0\",\n  \"provider\": \"Label Studio\",\n  \"status\": \"ok\",\n  \"example\": true,\n  \"contract_origin\": \"Smart Tools illustrative internal contract; not a provider response\",\n  \"input\": {\n    \"task_ref\": \"example-panel-7\",\n    \"image_size_pixels\": [\n      1000,\n      500\n    ],\n    \"control\": \"defects\",\n    \"object\": \"image\"\n  },\n  \"data\": {\n    \"origin\": \"human_reviewed\",\n    \"cancelled\": false,\n    \"regions\": [\n      {\n        \"label\": \"scratch\",\n        \"region_ref\": \"example-region-1\",\n        \"box_xywh_percent\": [\n          10,\n          20,\n          30,\n          10\n        ],\n        \"box_xywh_pixels\": [\n          100,\n          100,\n          300,\n          50\n        ]\n      }\n    ]\n  },\n  \"error\": null\n}","decisions":[[{"en":"Input requirements","zh-TW":"輸入條件"},{"en":"Task media must be reachable and configuration names must match results; preserve original dimensions and rotation.","zh-TW":"任務媒體需可存取，設定名稱必須符合結果；保留原始尺寸及旋轉。"}],[{"en":"Expected success","zh-TW":"預期成功"},{"en":"Return reviewed regions with task and region references; keep model suggestions separate from human annotations.","zh-TW":"回傳含任務與區域引用的覆核結果，模型建議與人工標註分開。"}],[{"en":"Expected empty","zh-TW":"預期空值"},{"en":"Explicitly reviewed no-defect samples may have regions=[]; skipped or unlabelled tasks are pending, not negative.","zh-TW":"明確覆核無缺陷樣本可 regions=[]；略過或未標註任務為 pending，不是負樣本。"}],[{"en":"Expected failure","zh-TW":"預期失敗"},{"en":"Authentication, unreachable media and label-config mismatch return an error category with data=null.","zh-TW":"認證、媒體無法存取或標籤設定不符回傳錯誤分類與 data=null。"}],[{"en":"Acceptance","zh-TW":"驗收"},{"en":"Known 1000×500 fixture at 10/20/30/10 percent must become 100/100/300/50 pixels; inspect cancelled flags.","zh-TW":"1000×500 樣本的 10／20／30／10 百分比須轉為 100／100／300／50 像素；檢查取消旗標。"}],[{"en":"Limitations","zh-TW":"限制"},{"en":"The contract is illustrative; edition-specific review endpoints and native payloads must be checked during implementation.","zh-TW":"契約僅為示意，實作時需核對版本專屬覆核端點與原生格式。"}],[{"en":"Data and runtime","zh-TW":"資料與執行環境"},{"en":"Separate annotation server, media bucket and ML backend access; define deletion and snapshot retention.","zh-TW":"分別處理標註伺服器、媒體 bucket 與 ML 後端存取，定義刪除與快照保留。"}]],"expected_results":[{"scenario":{"en":"Reviewed region","zh-TW":"已覆核區域"},"input":{"en":"Known rectangle on a 1000×500 image.","zh-TW":"1000×500 影像上的已知矩形。"},"output":{"en":"ok; correct percentage and pixel coordinates.","zh-TW":"ok；正確百分比與像素座標。"},"acceptance":{"en":"Exact task/control mapping and coordinate conversion.","zh-TW":"任務／控制對應與座標轉換精確。"}},{"scenario":{"en":"Reviewed empty","zh-TW":"已覆核空值"},"input":{"en":"Explicitly reviewed no-defect sample.","zh-TW":"明確覆核無缺陷樣本。"},"output":{"en":"ok; regions=[] with review provenance.","zh-TW":"ok；regions=[] 並保留覆核來源。"},"acceptance":{"en":"No cancelled or unlabelled task treated as negative.","zh-TW":"不將取消或未標註任務視為負樣本。"}},{"scenario":{"en":"Skipped task","zh-TW":"略過任務"},"input":{"en":"Annotation marked cancelled/skipped.","zh-TW":"標註被取消或略過。"},"output":{"en":"pending; excluded from accepted ground truth.","zh-TW":"pending；排除於已接受真值之外。"},"acceptance":{"en":"Skipped count remains visible in reconciliation.","zh-TW":"核對時保留可見略過筆數。"}},{"scenario":{"en":"Configuration mismatch","zh-TW":"設定不符"},"input":{"en":"Prediction refers to a missing control name.","zh-TW":"預測引用不存在的控制名稱。"},"output":{"en":"error; data=null; schema_mismatch.","zh-TW":"error；data=null；schema_mismatch。"},"acceptance":{"en":"Reject before storing misleading training labels.","zh-TW":"儲存誤導訓練標籤前拒絕。"}}]},"schema_version":"1.0.0","type":"development-proposal","product_id":"industrial-api:LabelStudioAPI","name":"Label Studio API","provider":"HumanSignal","url":"https://smart-tools.ai/product/LabelStudioAPI","localized_urls":{"en":"https://smart-tools.ai/product/LabelStudioAPI","zh-TW":"https://smart-tools.ai/zh-tw/product/LabelStudioAPI"},"category":"vision","capability_id":"cap:computer-vision","technology_hub":"https://smart-tools.ai/industrial-ai/computer-vision","interface_kind":"API / SDK","deployment":"hybrid","official_documentation":"https://labelstud.io/guide/api","sources":["https://labelstud.io/guide/api","https://humansignal.com/about/","https://api.labelstud.io/api-reference/introduction/getting-started","https://api.labelstud.io/tutorials/tutorials/create-a-project","https://labelstud.io/guide/setup","https://labelstud.io/guide/tasks","https://labelstud.io/guide/predictions","https://api.labelstud.io/api-reference/api-reference/annotations/create","https://labelstud.io/guide/export","https://labelstud.io/guide/ml_create","https://labelstud.io/guide/storage","https://labelstud.io/guide/webhooks","https://labelstud.io/guide/access_tokens","https://labelstud.io/guide/ml"],"source_review":{"level":"P1","status":"official-source-reviewed","checked_at":"2026-10-08"},"provider_summary":{"en":"Create labeling projects and exchange annotation data programmatically.","zh-TW":"以程式建立標註專案並交換標註資料。"},"proposed_product":{"en":"Label review workflow","zh-TW":"標註審核工作流程"},"feasibility":{"tier":"prototype","rationale":{"en":"Test one documented operation with a small real sample after access is confirmed. This is a development judgment, not a delivery estimate.","zh-TW":"確認存取後，用少量真實樣本測試一個有文件的操作。此為開發判斷，不是交期估算。"},"basis":"development-judgment;not-traffic-ranked"},"proposed_inputs":{"en":"A small authorized image dataset, task definition and reference annotations.","zh-TW":"少量經授權影像、任務定義與參考標註。"},"proposed_deliverable":{"en":"A reviewable result with image references, labels or annotation state; keep original files.","zh-TW":"可審核的影像引用、標籤或標註狀態；保留原始檔案。"},"acceptance_criterion":{"en":"Compare the supported operation against a labeled sample; report errors and missing results separately.","zh-TW":"用已標註樣本比對支援的操作；錯誤與缺漏結果分開呈現。"},"dependencies":{"en":"Dataset access, image rights and a supported model or annotation project.","zh-TW":"資料集存取、影像使用權與支援的模型或標註專案。"},"integration_condition":null,"proposed_adapter_envelope":{"provider":"HumanSignal","operation":"chosen-documented-operation","source_url":"https://labelstud.io/guide/api","captured_at":"ISO-8601 timestamp","status":"ok|pending|unknown|failed","data":"provider response mapped by the team","evidence":"source references","errors":"explicit error details"},"adapter_envelope_status":"proposed-internal-contract;not-a-provider-response","development_status":"concept-specification","integration_test":"not-run","pricing_status":"provider-terms-review-required","estimate_status":"requires-access-and-sample-validation","traffic_status":"not-measured-in-this-assessment","measurement_events":["product_view","product_to_docs","product_to_spec","bridge_to_industrial_ai"]}