모델 레지스트리 API
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
이 API를 사용하여 머신러닝 모델 레지스트리와 상호 작용합니다. 각 엔드포인트의 :model_version_id 속성은 모델 버전 ID 또는 후보 실행 ID를 허용합니다. 머신러닝 모델 패키지에서 지정된 파일을 다운로드합니다.
이 API를 사용하여 머신러닝 모델 레지스트리와 상호 작용합니다.
각 엔드포인트의 :model_version_id 속성은 모델 버전 ID 또는 후보 실행 ID를 허용합니다.
자세한 내용은 모델 버전 및 후보 ID를 참조하세요.
머신러닝 모델 패키지 파일 다운로드#
머신러닝 모델 패키지에서 지정된 파일을 다운로드합니다.
GET /api/v4/projects/:id/packages/ml_models/:model_version_id/files/(*path/):file_name
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로. |
model_version_id |
정수 또는 문자열 | Yes | 모델 버전 ID 또는 후보 실행 ID. 모델 버전 및 후보 ID 참조. |
file_name |
문자열 | Yes | 파일명. |
path |
문자열 | No | 파일의 디렉터리 경로. |
성공하면 200 OK와 파일 내용을 반환합니다.
요청 예시:
curl --header "Authorization: Bearer <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/2/files/foo.txt"
디렉터리 경로가 있는 요청 예시:
curl --header "Authorization: Bearer <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/2/files/my_dir/foo.txt"
모델 패키지 파일 업로드#
머신러닝 모델 패키지에 파일을 업로드합니다.
업로드 권한 부여#
머신러닝 모델 패키지에 파일 업로드를 승인합니다.
PUT /api/v4/projects/:id/packages/ml_models/:model_version_id/files/(*path/):file_name/authorize
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로. |
model_version_id |
정수 또는 문자열 | Yes | 모델 버전 ID 또는 후보 실행 ID. 모델 버전 및 후보 ID 참조. |
file_name |
문자열 | Yes | 파일명. |
path |
문자열 | No | 파일의 디렉터리 경로. |
성공하면 200 OK를 반환합니다.
요청 예시:
curl --request PUT \
--header "Authorization: Bearer <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/2/files/model.pkl/authorize"
파일 전송#
머신러닝 모델 패키지에 파일을 업로드합니다.
PUT /api/v4/projects/:id/packages/ml_models/:model_version_id/files/(*path/):file_name
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로. |
model_version_id |
정수 또는 문자열 | Yes | 모델 버전 ID 또는 후보 실행 ID. 모델 버전 및 후보 ID 참조. |
file_name |
문자열 | Yes | 파일명. |
path |
문자열 | No | 파일의 디렉터리 경로. |
file |
파일 | Yes | 업로드할 파일. |
성공하면 201 Created를 반환합니다.
요청 예시:
curl --request PUT \
--header "Authorization: Bearer <your_access_token>" \
--form "file=@model.pkl" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/2/files/model.pkl"
디렉터리 경로가 있는 요청 예시:
curl --request PUT \
--header "Authorization: Bearer <your_access_token>" \
--form "file=@model.pkl" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/2/files/my_dir/model.pkl"
모델 버전 및 후보 ID#
:model_version_id 속성은 모델 버전 ID 또는 후보 실행 ID를 허용합니다.
모델 버전 ID를 찾으려면 모델 버전 페이지의 URL을 확인합니다.
예를 들어 https://gitlab.example.com/my-namespace/my-project/-/ml/models/1/versions/5에서
모델 버전 ID는 5입니다.
curl --header "Authorization: Bearer <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/5/files/model.pkl"
후보 실행 ID를 사용하려면 후보의 내부 ID 앞에 candidate:를 붙입니다. 예를 들어
https://gitlab.example.com/my-namespace/my-project/-/ml/candidates/5에서
:model_version_id의 값은 candidate:5입니다.
curl --header "Authorization: Bearer <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/packages/ml_models/candidate:5/files/model.pkl"