---
title: "Train Models"
method: POST
path: "/api/v1/cross-physics/helium-starlink/train"
tags: ["Helium-Starlink Coupling"]
---

# Train Models

`POST /api/v1/cross-physics/helium-starlink/train`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/cross-physics/helium-starlink/train`
- Auth: none declared

Trigger HSC model training with latest data.

Retrains the three HSC models (anomaly detector, precursor
classifier, RF corrector) using the most recent Starlink +
Helium observations centred on the given location.

Training uses RandomizedSearchCV for hyperparameter tuning,
5-fold cross-validation, and CalibratedClassifierCV for
probability calibration.  Results are registered in the
model registry (common/model_registry.py).

This endpoint is intended for scheduled retraining or manual
triggering after significant new data ingestion.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- HSCAnalysisRequest: Request body for Helium-Starlink coupling analysis endpoints.
  - `lat` number, required: Latitude in decimal degrees (WGS84)
  - `lon` number, required: Longitude in decimal degrees (WGS84)
  - `radius_km` number: Analysis radius in kilometres (default 50)
  - `include_training` boolean: If True, trigger model retraining with latest data

## Response `200`

Successful Response

- HSCTrainResponse: Response body for model training trigger.
  - `status` string, required: Training status
  - `models_trained` integer, required: Number of models trained
  - `results` object: Per-model training results (accuracy, F1, etc.)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)