---
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.

## Headers

- `Api-Key` string, required

## 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.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)