---
title: "Train a custom Ideogram v3 model"
method: POST
path: "/v1/ideogram-v3/train-model"
tags: ["models"]
---

# Train a custom Ideogram v3 model

`POST /v1/ideogram-v3/train-model`

Start training a custom Ideogram v3 model from a dataset using default hyperparameters. The dataset must contain at least 15 images and a maximum of 100 images.

## Request body

- TrainModelV3Request — Training request for a custom Ideogram v3 model using default hyperparameters.
  - `dataset_id` string, required — ID of the dataset to train the model from.
  - `model_name` string, required — Name for the trained model. Must be 5-30 characters, alphanumeric with spaces and hyphens allowed.

## Response `200`

Training started successfully

- TrainDatasetModelResponse
  - `model_id` string, required — Unique identifier of the created model.
  - `dataset_id` string, required — Identifier of the dataset used for training.
  - `training_status` string, required — Current training status of the model.
  - `model_name` string, required — Name of the model.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Dataset not found

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/b560c0ad0618/schema)