> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/models/ja/model-ids.md).

# モデル ID

モデル ID の構成と、従来の project/version ID がモデルに解決される仕組み。

トレーニング済みの各モデルには、デプロイ、推論の実行、またはワークフローのモデルブロックでの選択時に識別するためのモデルIDがあります。このページでは、モデルIDの現在の構造と、以前の（レガシー）ID形式が一部の状況で引き続きサポートされる仕組みについて説明します。

## モデルIDの構造

モデルIDは次の形式です `{workspace}/{model-slug}`。最初の部分はワークスペースのURLスラッグです。2番目の部分であるモデルスラッグは、ワークスペース内のモデルを識別し、ハイフンで結合された4つの部分から構成されます:

```
{project}-{version}-{architecture}-t{n}
```

* `project`: モデルが属するプロジェクトのURLスラッグ。例: `construction-safety-xpv3w`.
* `version`: モデルのトレーニングに使用されたデータセットバージョンの番号。例: `12`.
* `architecture`: トレーニングに使用したモデルアーキテクチャ。例: `rfdetr-small`.
* `t{n}`: バージョンのトレーニングカウンター。そのバージョンで最初に開始されたトレーニングはt1、2回目はt2、以降も同様です。

たとえば、URLスラッグが次のプロジェクトのバージョン3で実行された2回目のRF-DETR Smallトレーニングは、 `construction-safety-xpv3w` 次のワークスペース内で `my-workspace` 次のモデルIDを生成します `my-workspace/construction-safety-xpv3w-3-rfdetr-small-t2`.

モデルスラッグはトレーニングの開始時に割り当てられるため、モデルのトレーニング中でも、そのモデルに付与されるIDを確認できます。トレーニングカウンターのサフィックスが再利用されることはありません。トレーニングが失敗またはキャンセルされた場合、その番号はスキップされ、同じバージョンで次に行うトレーニングには次の番号が付与されます。

A [ニューラルアーキテクチャ探索](https://docs.roboflow.com/models/ja/xue-xi/neural-architecture-search.md) トレーニングでは、多数の候補モデルが生成されます。NAS候補モデルのIDは他のモデルIDと同様ですが、二重ハイフンと6文字のハッシュが末尾に追加されます（例: `my-workspace/construction-safety-xpv3w-3-rfdetr-nas-t1--9589f2`）。v2トレーニングエンドポイントでは、NASトレーニングの `modelType` は `rfdetr-nas-parent`として報告され、各候補モデルは `rfdetr-nas`.

## モデルIDを見つける

トレーニング済みモデルのIDは、Webアプリ、HTTP API、またはRoboflow MCP Serverで確認できます。

### Webアプリ

プロジェクトのサイドバーで「Models」をクリックして、 [Modelsページ](https://docs.roboflow.com/models/ja/ping-si/view-trained-models.md)を開きます。各モデルには、「ID:」ラベルの横にそのIDが表示され、その隣に「Copy Model ID」ボタンがあります。同じIDとコピーボタンは、モデルの詳細ビューおよび各バージョンページのモデルテーブルにも表示されます。

### HTTP API

#### プロジェクトのモデル一覧

プロジェクトでトレーニングされたすべてのモデルを返します。各エントリの `url` フィールドがモデルIDです。

{% openapi src="/files/dcbd935399d52f4a63b56fcecf5b25782856bb21" path="/{workspace}/{project}/models" method="get" %}
[trainings.yaml](https://1194881119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcmo9mhfIjYrvFFy1U7dk%2Fuploads%2Fgit-blob-4028116544554a08ca7a36c2a7e2a8ecde4e69e3%2Ftrainings.yaml?alt=media)
{% endopenapi %}

#### トレーニング一覧

1つのバージョンのトレーニングを返します。各トレーニングでは、生成されたモデルのIDが `modelIds`に一覧表示されます。レガシーの単一モデルバージョンでは、トレーニングの `id` は次の形式です `{projectId}/{version}/training/0`、また `modelIds` には、そのバージョンの [レガシーID](#legacy-model-ids).

{% openapi src="/files/dcbd935399d52f4a63b56fcecf5b25782856bb21" path="/{workspace}/{project}/{version}/v2/trainings" method="get" %}
[trainings.yaml](https://1194881119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcmo9mhfIjYrvFFy1U7dk%2Fuploads%2Fgit-blob-4028116544554a08ca7a36c2a7e2a8ecde4e69e3%2Ftrainings.yaml?alt=media)
{% endopenapi %}

#### トレーニングを取得

ステータス、メトリクス、および各モデルのIDを `models[].modelId`で含む1件のトレーニングを返します。 `trainingId` は、そのバージョンにトレーニングが1件しかない場合は省略できます。複数ある場合、リクエストは `409`.

{% openapi src="/files/dcbd935399d52f4a63b56fcecf5b25782856bb21" path="/{workspace}/{project}/{version}/v2/trainings/get" method="get" %}
[trainings.yaml](https://1194881119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcmo9mhfIjYrvFFy1U7dk%2Fuploads%2Fgit-blob-4028116544554a08ca7a36c2a7e2a8ecde4e69e3%2Ftrainings.yaml?alt=media)
{% endopenapi %}

### MCP Server

この [Roboflow MCP Server](https://docs.roboflow.com/agents/mcp-server) は、モデルIDを返すツールを提供します。 `models_list` は、1つのプロジェクトのトレーニング済みモデルを一覧表示します（ワークスペースは接続の認証情報から取得され、プロジェクトは次の値として渡されます: `project_id`）。各モデルのIDをその `url` フィールドで返し、バージョンまたはNAS実行による任意のフィルタリングも可能です。 `trainings_get` および `trainings_list` は、各トレーニングで生成されたモデルのIDを返します。エージェントは、これらのIDを次のような他のツールに渡すことができます: `models_infer`.

## レガシーモデルID

以前は、Roboflowのデータセットバージョンでは実行できるトレーニングが1件だけだったため、モデルは次の形式のIDによって一意に決定されていました `{project}/{version}`.

たとえば、 `construction-site-safety/3` は以前、 *その* プロジェクトのバージョン3でトレーニングされたモデルを指していました。最初の部分はワークスペースではなくプロジェクトのURLスラッグで、2番目の部分はバージョン番号です。これは、古いSDK、コードスニペット、Inferenceインストールで使用される形式です（例: `model_id="construction-site-safety/3"`).

現在は、 [複数のトレーニング](https://docs.roboflow.com/models/ja/versions-trainings-and-models.md) をデータセットバージョンで実行できるため、これらのレガシー形式のIDは推奨されなくなりました。2026年6月30日以降に開始された新しいトレーニングにこのようなIDを使用しようとすると、内部的に新形式のIDへ解決されます。

## レガシーIDの解決方法

レガシー形式のIDはエイリアスを通じて引き続き機能します。あるバージョンで最初に開始されたトレーニングが正常に完了すると、Roboflowはそのバージョンのレガシー `{project}/{version}` IDを新しいモデルIDにリンクします。古いInferenceインストールからの重みダウンロードを含め、レガシーIDを使用するリクエストは自動的にそのモデルへ解決されます。

エイリアスは、バージョンで *最初の* トレーニングによってのみ作成され、その後は変更されません:

* 最初のトレーニングが正常に完了した場合、同じバージョンでさらにモデルをトレーニングした後も、レガシーIDは永続的にそのモデルを指します。後続のモデルは、それぞれ固有のモデルIDで参照してください。
* 最初のトレーニングが失敗またはキャンセルされた場合、エイリアスは作成されず、そのバージョンで後から行われるトレーニングでも作成されません。

エイリアスのないバージョンでも、モデルをちょうど1つだけ保持している限り、そのレガシーIDで参照できます。複数のモデルを保持していてエイリアスがない場合、参照が曖昧になるためレガシーIDを使用したリクエストは失敗し、モデル固有のIDを使用する必要があります。

{% hint style="info" %}
レガシーIDは後方互換性のために存在します。新しい統合では完全なモデルIDを優先してください。完全なモデルIDは曖昧さがなく、バージョン上のすべてのモデルで機能します。
{% endhint %}
