ML 플랫폼 API
배치 추론, ML 플러그인, 드리프트 모니터링, what-if 실험, 모델 접근 grant, MLflow 프록시 API입니다. 서빙(배포)은 Serving 참조.
배치 추론
prefix: /api/v1/ml/batch
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/ml/batch/jobs | 배치 잡 목록 |
| POST | /api/v1/ml/batch/jobs | 잡 생성 |
| GET | /api/v1/ml/batch/jobs/{job_id} | 잡 상세 |
| PUT | /api/v1/ml/batch/jobs/{job_id} | 잡 수정 |
| DELETE | /api/v1/ml/batch/jobs/{job_id} | 잡 삭제 |
| POST | /api/v1/ml/batch/jobs/{job_id}/run | 수동 실행 |
| GET | /api/v1/ml/batch/runs · /runs/{run_id} | 실행 목록/상세 |
ML 플러그인
prefix: /api/v1/ml-plugins
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/ml-plugins · /{plugin_id} | 목록/상세 |
| GET | /api/v1/ml-plugins/{plugin_id}/capabilities | 플러그인 기능 |
| POST | /api/v1/ml-plugins | 등록 |
| PUT · DELETE | /api/v1/ml-plugins/{plugin_id} | 수정/삭제 |
| POST | /api/v1/ml-plugins/{plugin_id}/train | 학습 트리거 |
드리프트 모니터링
prefix: /api/v1/models/{model_name}/drift
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/models/{model_name}/drift | 드리프트 리포트 목록 |
| GET | /api/v1/models/{model_name}/drift/{report_id} | 리포트 상세 |
| GET | /api/v1/models/{model_name}/drift/{report_id}/distribution | 분포 데이터 |
| POST | /api/v1/models/{model_name}/drift/compute | 드리프트 계산 |
| PUT · DELETE | /api/v1/models/{model_name}/drift/{report_id} | 수정/삭제 |
| GET · POST | /api/v1/models/{model_name}/drift-alerts | 알림 규칙 목록/생성 |
| PUT · DELETE | /api/v1/models/{model_name}/drift-alerts/{rule_id} | 알림 규칙 수정/삭제 |
What-if 실험
prefix: /api/v1/serving/whatif
| Method | Path | 설명 |
|---|---|---|
| POST · GET | /api/v1/serving/whatif/experiments | 실험 생성/목록 |
| GET | /api/v1/serving/whatif/experiments/{experiment_id} | 실험 상세 |
| POST | /api/v1/serving/whatif/experiments/{experiment_id}/scenarios | 시나리오 추가 |
| DELETE | /api/v1/serving/whatif/experiments/{experiment_id}/scenarios/{scenario_id} | 시나리오 삭제 |
| GET | /api/v1/serving/whatif/experiments/{experiment_id}/compare | 시나리오 비교 |
모델 접근 Grant (ABAC)
prefix: /api/v1/model-grants
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/model-grants | grant 목록 |
| GET | /api/v1/model-grants/check | 접근 체크 |
| GET | /api/v1/model-grants/{grant_id} | 상세 |
| POST | /api/v1/model-grants | grant 생성 |
| PUT · DELETE | /api/v1/model-grants/{grant_id} | 수정/삭제 |
MLflow 프록시
prefix: /api/v1/models
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/models/experiments · /experiments/{experiment_id} | 실험 목록/상세 |
| GET | /api/v1/models/registered · /registered/{name} | 등록 모델 목록/상세 |
인증
JWT Bearer 필요. 모델 grant(ABAC)는 subject_id 매칭으로 시행되며(safe_username 기반), 배치/플러그인 변경은 해당 스코프 권한이 필요합니다.