v1

latestOpenAPI 3.1.02026-07-26243347.4 KB

training

Start training a model

Start training an ACT or gr00t model on the specified dataset. This will upload a trained model to the Hugging Face Hub using the main branch of the specified dataset.

post/training/start

Request body

dataset_namestring required

Dataset repository ID on Hugging Face, should be a public dataset

model_namestring nullable

Name of the trained model to upload to Hugging Face, should be in the format phospho-app/<model_name> or <model_name>

model_type'ACT' | 'ACT_BBOX' | 'gr00t' | 'pi0' | 'custom' required

Type of model to train, supports 'ACT', 'gr00t', and 'pi0'

private_modeboolean

Whether to use private training (PRO users only)

user_hf_tokenstring nullable

User's personal HF token for private training

wandb_api_keystring nullable

WandB API key for tracking training, you can find it at https://wandb.ai/authorize

Example request

{
  "training_params": {
    "image_key": "main",
    "target_detection_instruction": "red/orange lego brick"
  }
}

Response

Successful Response

messagestring nullable

model_urlstring nullable

URL to the Hugging Face model card.

status'ok' | 'error'

training_idinteger nullable required

ID of the training to start. This is the ID returned by the training request.