---
title: "Get a training"
method: GET
path: "/trainings/{training_id}"
---

# Get a training

`GET /trainings/{training_id}`

Get the current state of a training.

Example cURL request:

```console
curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga
```

The response will be the training object:

```json
{
  "completed_at": "2023-09-08T16:41:19.826523Z",
  "created_at": "2023-09-08T16:32:57.018467Z",
  "error": null,
  "id": "zz4ibbonubfz7carwiefibzgga",
  "input": {
    "input_images": "https://example.com/my-input-images.zip"
  },
  "logs": "...",
  "metrics": {
    "predict_time": 502.713876
  },
  "output": {
    "version": "...",
    "weights": "..."
  },
  "started_at": "2023-09-08T16:32:57.112647Z",
  "status": "succeeded",
  "urls": {
    "web": "https://replicate.com/p/zz4ibbonubfz7carwiefibzgga",
    "get": "https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga",
    "cancel": "https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga/cancel"
  },
  "model": "stability-ai/sdxl",
  "version": "da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf",
}
```

`status` will be one of:

- `starting`: the training is starting up. If this status lasts longer than a few seconds, then it's typically because a new worker is being started to run the training.
- `processing`: the `train()` method of the model is currently running.
- `succeeded`: the training completed successfully.
- `failed`: the training encountered an error during processing.
- `canceled`: the training was canceled by its creator.

In the case of success, `output` will be an object containing the output of the model. Any files will be represented as HTTPS URLs. You'll need to pass the `Authorization` header to request them.

In the case of failure, `error` will contain the error encountered during the training.

Terminated trainings (with a status of `succeeded`, `failed`, or `canceled`) will include a `metrics` object with a `predict_time` property showing the amount of CPU or GPU time, in seconds, that the training used while running. It won't include time waiting for the training to start. The `metrics` object will also include a `total_time` property showing the total time, in seconds, that the training took to complete.

## Path parameters

- `training_id` string, required

## Response `200`

Success

- SchemasTrainingResponse
  - `completed_at` string, date-time — The time when the training completed
  - `created_at` string, date-time — The time when the training was created
  - `error` string, nullable — Error message if the training failed
  - `id` string — The unique ID of the training
  - `input` object — The input parameters used for the training
  - `logs` string — The logs from the training process
  - `metrics` object — Metrics about the training process
    - `predict_time` number — The amount of CPU or GPU time, in seconds, that the training used while running
    - `total_time` number — The total time, in seconds, that the training took to complete
  - `model` string — The name of the model in the format owner/name
  - `output` object — The output of the training process
    - `version` string — The version of the model created by the training
    - `weights` string — The weights of the trained model
  - `source` 'web' | 'api' — How the training was created
  - `started_at` string, date-time — The time when the training started
  - `status` 'starting' | 'processing' | 'succeeded' | 'failed' | 'canceled' — The current status of the training
  - `urls` object — URLs for interacting with the training
    - `cancel` string, uri — URL to cancel the training
    - `get` string, uri — URL to get the training details
  - `version` string — The ID of the model version used for training

---

[API](https://skmtc.net/replicate/apis/replicate-http-api.md) · [All operations](https://skmtc.net/replicate/apis/replicate-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicate/replicate-http-api/revisions/7a537f433b0b/schema)