> 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/ko/model-ids.md).

# 모델 ID

학습된 각 모델에는 배포하거나 추론을 실행하거나 Workflow 모델 블록에서 선택할 때 식별하는 모델 ID가 있습니다. 이 페이지에서는 모델 ID의 현재 구조와, 이전(레거시) 형식의 ID가 일부 상황에서 여전히 지원되는 방법을 설명합니다.

## 모델 ID 구조

모델 ID의 형식은 다음과 같습니다 `{workspace}/{model-slug}`. 첫 번째 부분은 Workspace URL 슬러그입니다. 두 번째 부분인 모델 슬러그는 워크스페이스 내에서 모델을 식별하며 하이픈으로 연결된 네 부분으로 구성됩니다:

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

* `project`: 모델이 속한 프로젝트의 URL 슬러그입니다. 예: `construction-safety-xpv3w`.
* `version`: 모델이 학습된 데이터셋 버전 번호입니다. 예: `12`.
* `아키텍처`: 학습에 사용된 모델 아키텍처입니다. 예: `rfdetr-small`.
* `t{n}`: 해당 버전의 학습 카운터입니다. 한 버전에서 시작된 첫 번째 학습은 t1, 두 번째는 t2이며, 이런 식으로 이어집니다.

예를 들어, URL 슬러그가 `construction-safety-xpv3w` 워크스페이스 `my-workspace` 에서는 다음 모델 ID가 생성됩니다 `my-workspace/construction-safety-xpv3w-3-rfdetr-small-t2`.

모델 슬러그는 학습이 시작될 때 할당되므로, 모델이 아직 학습 중일 때도 해당 모델의 ID를 확인할 수 있습니다. 학습 카운터 접미사는 재사용되지 않습니다. 학습이 실패하거나 취소되면 해당 번호는 건너뛰며, 그 버전의 다음 학습에는 그다음 번호가 할당됩니다.

하나의 [Neural Architecture Search](/models/ko/train/neural-architecture-search.md) 학습에서는 여러 후보 모델이 생성됩니다. NAS 후보 모델 ID는 다른 모델 ID와 비슷하지만, 뒤에 이중 하이픈과 6자 해시가 추가됩니다(예: `my-workspace/construction-safety-xpv3w-3-rfdetr-nas-t1--9589f2`). v2 trainings 엔드포인트에서 NAS 학습은 자신의 `modelType` 를 `rfdetr-nas-parent`를 보고하는 반면, 각 후보 모델은 `rfdetr-nas`.

## 모델 ID 찾기

웹 UI, REST API, 또는 Roboflow MCP Server를 통해 학습된 모든 모델의 ID를 확인할 수 있습니다.

{% tabs %}
{% tab title="웹 UI" %}
프로젝트 사이드바에서 "Models"를 클릭하여 [Models 페이지](/models/ko/evaluate/view-trained-models.md)를 여세요. 각 모델은 "ID:" 레이블 옆에 ID를 표시하며, 그 옆에 "Copy Model ID" 버튼이 있습니다. 동일한 ID와 복사 버튼은 모델의 상세 보기와 각 버전 페이지의 모델 표에도 나타납니다.
{% endtab %}

{% tab title="REST API" %}
이 [프로젝트 모델 목록](https://docs.roboflow.com/platform/workspaces/list-workspaces-and-projects#list-project-models) 엔드포인트는 프로젝트에서 학습된 모든 모델을 반환합니다. 각 항목의 `url` 필드는 모델 ID입니다:

```
GET https://api.roboflow.com/{workspace}/{project}/models?api_key=YOUR_API_KEY
```

```json
[
  {
    "url": "my-workspace/construction-safety-xpv3w-3-rfdetr-small-t2",
    "version": "3",
    "modelType": "rfdetr-small",
    "train": { "status": "finished" },
    ...
  },
  ...
]
```

특정 버전에서 학습된 모델을 찾으려면 v2 trainings 엔드포인트를 사용하세요. 버전의 학습 목록을 조회하면 각 학습과, 해당 학습이 생성한 모델의 ID가 `modelIds` 필드에 반환됩니다. 레거시 단일 모델 버전에서는 학습 `id` 은 다음 형식의 경로입니다 `{workspaceId}/{version}/training/0` (아래에 표시된 해시 대신), 그리고 `modelIds` 버전의 [레거시 ID](#legacy-model-ids) 를 포함합니다:

```
GET https://api.roboflow.com/{workspace}/{project}/{version}/v2/trainings?api_key=YOUR_API_KEY
```

```json
{
  "trainings": [
    {
      "id": "0a1b2c3d4e5f67890abc",
      "versionId": "3",
      "status": "finished",
      "modelType": "rfdetr-small",
      "modelIds": ["my-workspace/construction-safety-xpv3w-3-rfdetr-small-t2"],
      ...
    },
    ...
  ]
}
```

단일 학습을 조회하면 각 모델의 세부 정보가 반환되며, 각 모델의 ID가 `modelId` 필드에 포함됩니다. `models` 목록입니다. 다음은 생략할 수 있습니다 `trainingId` 버전에 학습이 하나만 있을 때는 가능하지만, 버전에 여러 학습이 있으면 이러한 요청은 409 오류로 실패합니다.

```
GET https://api.roboflow.com/{workspace}/{project}/{version}/v2/trainings/get?api_key=YOUR_API_KEY&trainingId={trainingId}
```

```json
{
  "trainingId": "0a1b2c3d4e5f67890abc",
  "versionId": "3",
  "status": "finished",
  "modelType": "rfdetr-small",
  "modelCount": 1,
  "models": [
    {
      "modelId": "my-workspace/construction-safety-xpv3w-3-rfdetr-small-t2",
      "modelType": "rfdetr-small",
      "status": "finished",
      "metrics": { ... }
    }
  ],
  ...
}
```

{% endtab %}

{% tab title="MCP" %}
이 [Roboflow MCP Server](https://docs.roboflow.com/agents/agents/mcp-server) 는 모델 ID를 반환하는 도구를 제공합니다. `models_list` 하나의 프로젝트에서 학습된 모델을 나열합니다(워크스페이스는 연결 자격 증명에서 가져오며, 프로젝트는 `project_id`로 전달되며, 각 모델의 ID를 `url` 필드에 반환합니다. 버전 또는 NAS 실행으로 선택적으로 필터링할 수 있습니다. `trainings_get` 및 `trainings_list` 각 학습이 생성한 모델의 ID를 반환합니다. 에이전트는 이러한 ID를 다음과 같은 다른 도구에 전달할 수 있습니다: `models_infer`.
{% endtab %}
{% endtabs %}

## 레거시 모델 ID

과거에는 Roboflow 데이터셋 버전에 학습을 한 번만 실행할 수 있었기 때문에, 모델은 다음 형식의 ID로 고유하게 결정되었습니다 `{project}/{version}`.

예를 들어, `construction-site-safety/3` 는 다음을 가리켰습니다 *해당* 그 프로젝트의 버전 3에서 학습된 모델입니다. 첫 번째 부분은 워크스페이스가 아니라 프로젝트 URL 슬러그이고, 두 번째 부분은 버전 번호입니다. 이는 이전 SDK, 코드 스니펫, Inference 설치에서 사용하는 형식입니다(예: `model_id="construction-site-safety/3"`).

이제 실행할 수 있게 되었기 때문에 [둘 이상의 학습](/models/ko/versions-trainings-and-models.md) 를 데이터셋 버전에 대해 실행할 수 있으므로, 이러한 레거시 형식 ID는 더 이상 권장되지 않습니다. 2026년 6월 30일 이후에 시작된 새 학습에 이런 ID를 사용하려고 하면, 내부적으로는 새로운 형식의 ID로 해석됩니다.

## 레거시 ID가 해석되는 방식

레거시 형식 ID는 별칭을 통해 계속 작동합니다. 한 버전에서 시작된 첫 번째 학습이 성공적으로 완료되면, Roboflow는 해당 버전의 레거시 `{project}/{version}` ID를 새 모델 ID에 연결합니다. 이전 Inference 설치에서의 가중치 다운로드를 포함해 레거시 ID를 사용하는 요청은 자동으로 해당 모델로 해석됩니다.

별칭은 오직 *첫 번째* 버전의 학습에서만 생성되며 이후에는 변경되지 않습니다:

* 첫 번째 학습이 성공적으로 완료되면, 같은 버전에 더 많은 모델을 학습하더라도 레거시 ID는 해당 모델을 영구적으로 가리킵니다. 이후 모델은 각자의 모델 ID로 참조하세요.
* 첫 번째 학습이 실패하거나 취소되면 별칭이 생성되지 않으며, 그 버전의 이후 학습도 별칭을 만들지 않습니다.

별칭이 없는 버전도 모델이 정확히 하나만 있으면 레거시 ID로 참조할 수 있습니다. 여러 모델이 있고 별칭이 없으면, 레거시 ID로 하는 요청은 참조가 모호하여 실패하므로 모델 자체의 ID를 사용해야 합니다.

{% hint style="info" %}
레거시 ID는 하위 호환성을 위해 존재합니다. 새 통합에서는 전체 모델 ID를 사용하는 것이 좋습니다. 더 명확하며 버전의 모든 모델에서 작동합니다.
{% endhint %}