# 介面總表

> LMSP 1.0 全部介面的總表，包含方法、路徑、必需性和用途，以及關於路徑、驗證和可選介面的約定。

Source: https://madeforagent.com/zh-tw/lmsp/1.0/endpoints/
Language: zh-TW
Specification: LMSP 1.0 (draft)
Updated: 2026-11-08

## 4.1 介面總表 {#table}

合規的服務**必須**實作標記為「必需」的每個介面，**可以**實作可選介面，並透過其[服務描述](https://madeforagent.com/zh-tw/lmsp/1.0/discovery.md#service-description)中的能力旗標宣告。

| 方法 | 路徑 | 必需性 | 用途 |
| --- | --- | --- | --- |
| GET | `/.well-known/lmsp.json` | 必需 | [服務與能力發現](https://madeforagent.com/zh-tw/lmsp/1.0/discovery.md#service-description) |
| GET | `/lmsp/v1/openapi.json` | 必需 | 機器可讀的介面規範 |
| GET | `/lmsp/v1/health` | 必需 | [存活與就緒檢查](https://madeforagent.com/zh-tw/lmsp/1.0/common-rules.md#health) |
| POST | `/lmsp/v1/pair` | 必需 | [用配對碼換取 Bearer Token](https://madeforagent.com/zh-tw/lmsp/1.0/security.md#pairing) |
| GET | `/lmsp/v1/models` | 必需 | [取得本地模型列表](https://madeforagent.com/zh-tw/lmsp/1.0/models.md#list) |
| GET | `/lmsp/v1/models/{model_id}` | 必需 | [取得單個模型詳情](https://madeforagent.com/zh-tw/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/responses` | 必需 | [同步或串流生成](https://madeforagent.com/zh-tw/lmsp/1.0/responses.md#request) |
| GET | `/lmsp/v1/responses/{response_id}` | 可選 | [查詢已儲存的回應](https://madeforagent.com/zh-tw/lmsp/1.0/responses.md#sync) |
| POST | `/lmsp/v1/tasks` | 必需 | [建立非同步生成任務](https://madeforagent.com/zh-tw/lmsp/1.0/tasks.md#create) |
| GET | `/lmsp/v1/tasks/{task_id}` | 必需 | [查詢非同步任務](https://madeforagent.com/zh-tw/lmsp/1.0/tasks.md#create) |
| POST | `/lmsp/v1/tasks/{task_id}/cancel` | 必需 | [取消非同步任務](https://madeforagent.com/zh-tw/lmsp/1.0/tasks.md#cancel) |
| GET | `/lmsp/v1/tasks/{task_id}/events` | 可選 | [訂閱或恢復事件流](https://madeforagent.com/zh-tw/lmsp/1.0/tasks.md#events) |
| POST | `/lmsp/v1/models/{model_id}/load` | 可選 | [預載入模型](https://madeforagent.com/zh-tw/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/models/{model_id}/unload` | 可選 | [解除安裝模型](https://madeforagent.com/zh-tw/lmsp/1.0/models.md#operations) |

`/v1` 下相容 OpenAI 的介面，以及可選的相容 Ollama 的介面，列在[第 8 章](https://madeforagent.com/zh-tw/lmsp/1.0/compatibility.md)。

## 4.2 約定 {#conventions}

- **請求主體。** 請求主體和回應體均為 JSON（`application/json`），事件流（`text/event-stream`）和錯誤（`application/problem+json`）除外。
- **路徑引數。** 花括號中的名稱（如 `{model_id}`）是佔位符。取值**必須**經過百分號編碼。形如 `qwen3:14b-q4_k_m` 的模型 id 要寫成 `qwen3%3A14b-q4_k_m`。
- **驗證。** 除 `/.well-known/lmsp.json`、`/lmsp/v1/openapi.json`、`/lmsp/v1/health` 和 `/lmsp/v1/pair` 之外，每個介面都要求 `Authorization: Bearer <token>`。
- **可選介面。** 服務未實作的可選介面**必須**回傳 `501 Not Implemented`，錯誤碼為 `unsupported_capability`。
- **版本與錯誤。** 請求可以攜帶版本請求標頭，所有錯誤使用統一的格式，兩者均在[第 9 章](https://madeforagent.com/zh-tw/lmsp/1.0/common-rules.md)中定義。
- **合約。** 發布在 [`/lmsp/1.0/openapi.json`](https://madeforagent.com/lmsp/1.0/openapi.json) 的 OpenAPI 文件是本章的機器可讀形式。兩者如有差異，以文本為準。