GET /api/v1/training/catalog/tasks

GET/api/v1/training/catalog/tasks

CV 태스크 목록 (위저드 1단계)

위저드 1단계의 컴퓨터 비전 태스크 6종을 표시 순서대로 반환합니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

GET /api/v1/training/catalog/frameworks

GET/api/v1/training/catalog/frameworks

프레임워크 카탈로그 (위저드 2단계)

선택한 태스크에서 고를 수 있는 프레임워크 카드 목록을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
taskquerystring태스크 키 (1단계 선택값)

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/catalog/models

GET/api/v1/training/catalog/models

모델 변형 목록 (위저드 3단계)

모델 변형 테이블(파라미터 수(M), mAP)을 검색/페이지네이션과 함께 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
taskquerystring태스크 키
frameworkquerystring프레임워크 키 (빈 값 = 전체)
qquerystring모델명 검색어
pagequeryinteger

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/catalog/hyperparameters

GET/api/v1/training/catalog/hyperparameters

기본 하이퍼파라미터 YAML (위저드 7단계)

프레임워크의 기본 하이퍼파라미터 YAML 원문을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
frameworkquerystring프레임워크 키
modelquerystring모델 변형 키 (변형별 파라미터를 쓰는 프레임워크에 필요)

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/datasets

GET/api/v1/training/datasets

학습 가능 데이터셋 (위저드 4단계)

학습에 사용할 수 있는 데이터셋(FROZEN 상태, 학습 가능 파일 보유) 목록을 반환합니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

GET /api/v1/training/datasets/{dataset_id}/classes

GET/api/v1/training/datasets/{dataset_id}/classes

데이터셋 클래스 집계 (위저드 5단계)

데이터셋이 제공하는 학습 클래스 목록을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring
taskquerystring태스크 키: shape 호환성 판정 기준
frameworkquerystring프레임워크 키 (표 형식 판정용)
modelquerystring모델 변형 키 (라벨 컬럼 판정용)

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/runtime-images

GET/api/v1/training/runtime-images

외부 변형이 고를 수 있는 레지스트리 이미지 목록

내장 컨테이너 레지스트리에 있는 이미지를 노드가 pull 할 주소와 함께 나열합니다. 외부 학습 런타임 변형이 가리킬 대상 선택용입니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

GET /api/v1/training/runtimes

GET/api/v1/training/runtimes

학습 런타임 변형 목록

이 테넌트의 변형 목록을 게시 상태와 함께 반환합니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

POST /api/v1/training/runtimes

POST/api/v1/training/runtimes

학습 런타임 변형 생성

변형을 새로 만듭니다.

Request body: application/json, VariantCreate

FieldTypeRequiredDescription
namestring표시명
tagstring이미지 태그(불변)
descriptionstringDescription
build_argsobjectBuild Args
is_defaultbooleanIs Default
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/runtimes/{variant_id}

GET/api/v1/training/runtimes/{variant_id}

학습 런타임 변형 상세

변형 하나의 상세와 게시 상태를 반환합니다. VIEW 권한이 필요합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/training/runtimes/{variant_id}

PATCH/api/v1/training/runtimes/{variant_id}

학습 런타임 변형 수정

표시명·설명·build-arg 를 수정합니다(태그는 불변).

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Request body: application/json, VariantUpdate

FieldTypeRequiredDescription
namestring?Name
descriptionstring?Description
build_argsobject?Build Args
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/runtimes/{variant_id}

DELETE/api/v1/training/runtimes/{variant_id}

학습 런타임 변형 삭제

변형을 삭제합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/runtimes/{variant_id}/default

POST/api/v1/training/runtimes/{variant_id}/default

학습 런타임 변형 기본 지정

이 변형을 기본으로 지정합니다(기존 기본은 해제).

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/runtimes/{variant_id}/publish

POST/api/v1/training/runtimes/{variant_id}/publish

학습 런타임 변형 게시 시작

이 변형의 이미지를 굽고 레지스트리에 게시합니다.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/runtimes/{variant_id}/publish

DELETE/api/v1/training/runtimes/{variant_id}/publish

학습 런타임 변형 게시 중지

진행 중인 게시 Job 을 중지합니다.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/runtimes/{variant_id}/logs

GET/api/v1/training/runtimes/{variant_id}/logs

학습 런타임 변형 게시 로그

현재/마지막 게시 Job 의 로그를 반환합니다. VIEW 권한이 필요합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring
run_idquerystring?지난 게시 실행(Job 이름)을 지목해 보존 로그를 읽습니다

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/runtimes/{variant_id}/logs/raw

GET/api/v1/training/runtimes/{variant_id}/logs/raw

학습 런타임 변형 게시 로그 전문 내려받기

보존된 게시 로그 전문을 스트리밍합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
variant_idpathstring
run_idquerystring?지난 게시 실행(Job 이름). 비우면 현재 실행

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/stagers

GET/api/v1/training/stagers

데이터셋 스테이저 변형 목록

이 테넌트의 변형 목록을 게시 상태와 함께 반환합니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

POST /api/v1/training/stagers

POST/api/v1/training/stagers

데이터셋 스테이저 변형 생성

변형을 새로 만듭니다.

Request body: application/json, VariantCreate

FieldTypeRequiredDescription
namestring표시명
tagstring이미지 태그(불변)
descriptionstringDescription
build_argsobjectBuild Args
is_defaultbooleanIs Default
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/stagers/{variant_id}

GET/api/v1/training/stagers/{variant_id}

데이터셋 스테이저 변형 상세

변형 하나의 상세와 게시 상태를 반환합니다. VIEW 권한이 필요합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/training/stagers/{variant_id}

PATCH/api/v1/training/stagers/{variant_id}

데이터셋 스테이저 변형 수정

표시명·설명·build-arg 를 수정합니다(태그는 불변).

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Request body: application/json, VariantUpdate

FieldTypeRequiredDescription
namestring?Name
descriptionstring?Description
build_argsobject?Build Args
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/stagers/{variant_id}

DELETE/api/v1/training/stagers/{variant_id}

데이터셋 스테이저 변형 삭제

변형을 삭제합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/stagers/{variant_id}/default

POST/api/v1/training/stagers/{variant_id}/default

데이터셋 스테이저 변형 기본 지정

이 변형을 기본으로 지정합니다(기존 기본은 해제).

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/stagers/{variant_id}/publish

POST/api/v1/training/stagers/{variant_id}/publish

데이터셋 스테이저 변형 게시 시작

이 변형의 이미지를 굽고 레지스트리에 게시합니다.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/stagers/{variant_id}/publish

DELETE/api/v1/training/stagers/{variant_id}/publish

데이터셋 스테이저 변형 게시 중지

진행 중인 게시 Job 을 중지합니다.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/stagers/{variant_id}/logs

GET/api/v1/training/stagers/{variant_id}/logs

데이터셋 스테이저 변형 게시 로그

현재/마지막 게시 Job 의 로그를 반환합니다. VIEW 권한이 필요합니다.

Parameters

NameInTypeRequiredDescription
variant_idpathstring
run_idquerystring?지난 게시 실행(Job 이름)을 지목해 보존 로그를 읽습니다

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/stagers/{variant_id}/logs/raw

GET/api/v1/training/stagers/{variant_id}/logs/raw

데이터셋 스테이저 변형 게시 로그 전문 내려받기

보존된 게시 로그 전문을 스트리밍합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
variant_idpathstring
run_idquerystring?지난 게시 실행(Job 이름). 비우면 현재 실행

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/presets

GET/api/v1/training/presets

실험 프리셋 목록

서버에 미리 지정된 실험(프리셋) 목록을 반환합니다.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

GET /api/v1/training/experiments

GET/api/v1/training/experiments

학습 실험 목록

테넌트의 학습 실험 목록을 최신순으로 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
statusquerystring상태 필터 (빈 값 = 전체)
pagequeryinteger
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/experiments

POST/api/v1/training/experiments

학습 실험 제출 (START)

위저드 최종 config 를 제출해 학습 실험을 시작합니다.

Permission: DEVELOP

Parameters

NameInTypeRequiredDescription
presetquerystring출발한 프리셋 id (추적용, 선택)

Request body: application/json, ExperimentConfig

FieldTypeRequiredDescription
taskTaskType
frameworkstringFramework
modelstringModel
pretrainedPretrainedConfig
dataset_idstringDataset Id
cache_datasetbooleanCache Dataset
classesstring[]Classes
splitSplitConfig
hyperparametersstringHyperparameters
evaluationEvaluationConfig
exportExportConfig
servingServingConfig
runtime_variantstring?Runtime Variant
runtime_imagestring?Runtime Image
runtime_sharedbooleanRuntime Shared
gpuintegerGpu
experiment_namestringExperiment Name
register_modelbooleanRegister Model
register_model_namestringRegister Model Name

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}

GET/api/v1/training/experiments/{experiment_id}

학습 실험 상세

실험의 config 스냅샷/상태/결과 연결(mlflow_run_id)/스텝 플랜을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/experiments/{experiment_id}

DELETE/api/v1/training/experiments/{experiment_id}

학습 실험 삭제

종료 상태의 실험 레코드와 작업 디렉터리를 정리합니다.

Permission: OPERATE

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/log

GET/api/v1/training/experiments/{experiment_id}/log

학습 로그 파일 내려받기

실험의 train.log 전체를 텍스트 파일로 내려받습니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/launch

GET/api/v1/training/experiments/{experiment_id}/launch

학습 실행 스펙 (디버그: 환경 변수/볼륨/파드)

학습이 무엇을 받고 실행됐는지를 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/mlflow

GET/api/v1/training/experiments/{experiment_id}/mlflow

학습 실험의 MLflow run 딥링크

실험에 연결된 MLflow run 상세로의 딥링크 정보를 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/metrics

GET/api/v1/training/experiments/{experiment_id}/metrics

학습 실험 지표 시계열 (MLflow)

실험에 연결된 MLflow run 의 지표 시계열을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring
keysquerystring쉼표로 구분한 지표 키. 비우면 기본 선택만 담는다.
max_pointsqueryinteger0 = 서버 기본값

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/steps

GET/api/v1/training/experiments/{experiment_id}/steps

학습 실험 스텝 목록

실험의 스텝 플랜(상태/진행률/메시지 포함)을 반환합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/experiments/{experiment_id}/logs

GET/api/v1/training/experiments/{experiment_id}/logs

학습 로그 스트림 (SSE)

실험 이벤트를 SSE 로 실시간 스트리밍합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/experiments/{experiment_id}/stop

POST/api/v1/training/experiments/{experiment_id}/stop

학습 실험 정지 (graceful)

대기/실행 중인 실험을 안전하게 정지합니다.

Permission: DEVELOP

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/cache

GET/api/v1/training/cache

데이터셋 캐시 현황 (관리자)

스테이징된 데이터셋 캐시의 현황을 반환합니다(관리자 전용).

Responses

StatusDescription
200Successful Response (object)

DELETE /api/v1/training/cache

DELETE/api/v1/training/cache

데이터셋 캐시 전체 비우기 (관리자)

캐시를 비웁니다(실행 중인 학습이 쓰는 데이터셋은 남깁니다).

Responses

StatusDescription
200Successful Response (object)

DELETE /api/v1/training/cache/volumes/{name}

DELETE/api/v1/training/cache/volumes/{name}

남은 캐시 볼륨(PV) 지우기 (관리자)

클레임이 사라진 뒤에도 남아 있는 캐시 볼륨을 지웁니다(관리자 전용).

Parameters

NameInTypeRequiredDescription
namepathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/cache/{dataset_id}

DELETE/api/v1/training/cache/{dataset_id}

데이터셋 캐시 항목 비우기 (관리자)

한 데이터셋의 캐시를 비웁니다(관리자 전용).

Parameters

NameInTypeRequiredDescription
dataset_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/admin/runtime

GET/api/v1/training/admin/runtime

학습 러너 런타임 상태 (관리자)

학습 러너(Kubernetes Job)의 런타임 상태를 반환합니다(관리자 전용).

Responses

StatusDescription
200Successful Response (object)

POST /api/v1/training/admin/experiments/{experiment_id}/kill

POST/api/v1/training/admin/experiments/{experiment_id}/kill

학습 Job 강제 종료 (관리자)

학습 Job 을 즉시 강제 종료합니다(관리자 전용).

Parameters

NameInTypeRequiredDescription
experiment_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/weights

GET/api/v1/training/weights

테넌트 사전학습 가중치 목록

현재 테넌트가 올린 가중치를 최신순으로 조회합니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
frameworkquerystring프레임워크 필터
modelquerystring카탈로그 모델 키 필터
pagequeryinteger

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/weights

POST/api/v1/training/weights

가중치 업로드 시작

업로드 세션을 엽니다(아직 바이트는 보내지 않습니다).

Permission: DEVELOP

Request body: application/json, WeightCreate

FieldTypeRequiredDescription
namestringName
frameworkstringFramework
modelstringModel
filenamestringFilename
size_bytesintegerSize Bytes

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/training/weights/{weight_id}/chunks

PATCH/api/v1/training/weights/{weight_id}/chunks

가중치 청크 전송

파일의 한 청크를 이어붙입니다(application/octet-stream).

Permission: DEVELOP

Parameters

NameInTypeRequiredDescription
weight_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/training/weights/{weight_id}:complete

POST/api/v1/training/weights/{weight_id}:complete

업로드 마감

업로드를 마감하고 검증을 시작합니다.

Permission: DEVELOP

Parameters

NameInTypeRequiredDescription
weight_idpathstring

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/training/weights/{weight_id}

GET/api/v1/training/weights/{weight_id}

가중치 상세

가중치 한 건: 업로드를 이어받을 때 오프셋을 여기서 읽습니다.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
weight_idpathstring

Responses

StatusDescription
200Successful Response (WeightOut)
422Validation Error (HTTPValidationError)

DELETE /api/v1/training/weights/{weight_id}

DELETE/api/v1/training/weights/{weight_id}

가중치 삭제

가중치와 그 객체를 지웁니다.

Permission: DEVELOP

Parameters

NameInTypeRequiredDescription
weight_idpathstring

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

Written for the platform as of 2026-09-21.

© Geo-MLOps