models
models API, 엔드포인트 12개 (자동 생성)
모델 레지스트리: 스테이지 매트릭스, 버전 이력, 일대일 비교 및 프로덕션 승격 요청.
GET /api/v1/models
GET/api/v1/models
스테이지 매트릭스를 포함한 등록 모델 목록
테넌트의 등록된 모델을 스테이지별 매트릭스와 함께 나열합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
production | query | boolean? | true = Production 버전이 있는 모델만, false = 없는 모델만 | |
page | query | integer | ||
page_size | query | integer? | ||
q | query | string? | 이름 부분 일치 검색 | |
sort | query | string? | 정렬 키 | |
order | query | string | asc | desc |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/summary
GET/api/v1/models/summary
production/staging/archived 개수
테넌트의 모델 개수를 스테이지별로 집계합니다.
필요 권한: VIEW
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/models/{name}/versions
GET/api/v1/models/{name}/versions
버전 이력
등록된 모델의 전체 버전 이력을 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
page | query | integer | ||
page_size | query | integer? |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/versions/{version}
GET/api/v1/models/{name}/versions/{version}
모델 버전 단건 조회
모델 버전 하나를 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/{version}/download
GET/api/v1/models/{name}/{version}/download
모델 버전 아티팩트 다운로드
모델 버전의 아티팩트를 파일로 내려받습니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/compare
GET/api/v1/models/{name}/compare
두 모델 버전 비교
모델의 두 버전을 나란히 일대일 비교합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
from | query | string | ✓ | |
to | query | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/{version}/comments
GET/api/v1/models/{name}/{version}/comments
일대일 비교 코멘트 목록
특정 모델 버전에 대한 일대일 비교(H2H) 코멘트를 나열합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/comments
POST/api/v1/models/{name}/{version}/comments
코멘트 추가
모델 버전에 일대일 비교(H2H) 코멘트를 추가합니다.
필요 권한: DEVELOP
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
요청 본문: application/json, CommentCreate
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
body | string | ✓ | Body |
응답
| 상태 | 설명 |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/promote
POST/api/v1/models/{name}/{version}/promote
프로덕션 승격 요청
모델 버전을 Production으로 승격하도록 요청합니다(화면 8 진입점).
필요 권한: PRODUCTION_PROMOTE
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
요청 본문: application/json, PromoteRequest
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
to_version | string | ✓ | To Version |
reason | string | ✓ | Reason |
rollback_conditions | string? | Rollback Conditions | |
scope | string? | Scope |
응답
| 상태 | 설명 |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/stage
POST/api/v1/models/{name}/{version}/stage
모델 버전 스테이지 강등
모델 버전을 Archived/Staging/None 스테이지로 옮깁니다.
필요 권한: STAGING_PROMOTE
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
요청 본문: application/json, StageChange
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
stage | string | ✓ | Stage |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/models/{name}/{version}
DELETE/api/v1/models/{name}/{version}
모델 버전 등록 해제
등록된 모델에서 버전 하나를 삭제합니다.
필요 권한: MODEL_REGISTER
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/models/{name}
DELETE/api/v1/models/{name}
등록 모델 삭제
등록된 모델을 전체 버전과 함께 레지스트리에서 삭제합니다.
필요 권한: MODEL_REGISTER
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
name | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |