# エンドポイント

> LMSP 1.0 のエンドポイント一覧。メソッド、パス、要件レベル、用途に加え、パス、認証、任意エンドポイントに関する規約を示します。

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

## 4.1 エンドポイント一覧 {#table}

適合するサービスは、必須とされたすべてのエンドポイントを実装し**なければならない**。任意のエンドポイントは実装し**てもよく**、その場合は[サービス記述](https://madeforagent.com/ja/lmsp/1.0/discovery.md#service-description)の機能フラグで示す。

| メソッド | パス | 要件 | 用途 |
| --- | --- | --- | --- |
| GET | `/.well-known/lmsp.json` | 必須 | [サービスと機能の発見](https://madeforagent.com/ja/lmsp/1.0/discovery.md#service-description) |
| GET | `/lmsp/v1/openapi.json` | 必須 | 機械可読なインターフェース仕様 |
| GET | `/lmsp/v1/health` | 必須 | [稼働状態と準備状態の確認](https://madeforagent.com/ja/lmsp/1.0/common-rules.md#health) |
| POST | `/lmsp/v1/pair` | 必須 | [ペアリングコードをベアラートークンと交換する](https://madeforagent.com/ja/lmsp/1.0/security.md#pairing) |
| GET | `/lmsp/v1/models` | 必須 | [ローカルモデルを一覧する](https://madeforagent.com/ja/lmsp/1.0/models.md#list) |
| GET | `/lmsp/v1/models/{model_id}` | 必須 | [モデルを 1 つ取得する](https://madeforagent.com/ja/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/responses` | 必須 | [同期生成またはストリーミング生成](https://madeforagent.com/ja/lmsp/1.0/responses.md#request) |
| GET | `/lmsp/v1/responses/{response_id}` | 任意 | [保存済みのレスポンスを取得する](https://madeforagent.com/ja/lmsp/1.0/responses.md#sync) |
| POST | `/lmsp/v1/tasks` | 必須 | [非同期の生成タスクを作成する](https://madeforagent.com/ja/lmsp/1.0/tasks.md#create) |
| GET | `/lmsp/v1/tasks/{task_id}` | 必須 | [非同期タスクを取得する](https://madeforagent.com/ja/lmsp/1.0/tasks.md#create) |
| POST | `/lmsp/v1/tasks/{task_id}/cancel` | 必須 | [非同期タスクをキャンセルする](https://madeforagent.com/ja/lmsp/1.0/tasks.md#cancel) |
| GET | `/lmsp/v1/tasks/{task_id}/events` | 任意 | [イベントストリームを購読または再開する](https://madeforagent.com/ja/lmsp/1.0/tasks.md#events) |
| POST | `/lmsp/v1/models/{model_id}/load` | 任意 | [モデルを事前ロードする](https://madeforagent.com/ja/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/models/{model_id}/unload` | 任意 | [モデルをアンロードする](https://madeforagent.com/ja/lmsp/1.0/models.md#operations) |

`/v1` 配下の OpenAI 互換エンドポイントと、任意の Ollama 互換エンドポイントは[第 8 章](https://madeforagent.com/ja/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>` を必要とする。
- **任意のエンドポイント。** サービスが実装していない任意のエンドポイントは、エラーコード `unsupported_capability` を付けて `501 Not Implemented` で応答し**なければならない**。
- **バージョンとエラー。** リクエストはバージョンヘッダーを携えることができ、すべてのエラーは 1 つの形式を使う。どちらも[第 9 章](https://madeforagent.com/ja/lmsp/1.0/common-rules.md)で定義している。
- **契約。** [`/lmsp/1.0/openapi.json`](https://madeforagent.com/lmsp/1.0/openapi.json) で公開されている OpenAPI ドキュメントは、このページの機械可読な形式である。両者が異なる場合は、本文が規範である。