You're looking at a specific version of this model. Jump to the model overview.

simpletuner /ideogram-4:610984e2

Input schema

The fields you can use to run this model with an API. If you don’t give a value for a field its default value will be used.

Field Type Default value Description
train_data
string
Zip or tar of training images. Matching .txt captions are used when present; missing captions get structured Ideogram JSON using trigger_word.
hf_dataset
string
Hugging Face dataset repo ID to use when no archive is provided (e.g., user/dataset).
pixel_area
integer
1024

Min: 256

Max: 2048

Pixel-area resolution; also applied to min/max/target size and validation resolution.
enable_crop
boolean
True
Enable cropping when preparing samples.
crop_style
None
center
Crop location style when cropping is enabled.
crop_aspect
None
square
Aspect handling for crops: square (1:1) or preserve source aspect.
trigger_word
string
TOK
Subject token used in generated JSON captions and validation prompts.
caption_strategy
None
textfile
Caption strategy for uploaded archives. textfile uses matching .txt captions and generated JSON fallbacks; filename derives captions from filenames; instanceprompt uses one structured JSON trigger prompt for every image.
train_batch_size
integer
1

Min: 1

Max: 2

Training batch size (1-2). Keep 1 unless the GPU has enough memory.
checkpoints_total_limit
integer
3

Min: 1

Max: 5

Maximum checkpoints to retain (max 5).
checkpoint_epoch_interval
integer
5

Min: 1

Write a checkpoint every N epochs.
num_train_epochs
integer
25

Min: 1

Total training epochs.
max_train_steps
integer
0
Optional max train steps override (0 disables the step limit).
s3_bucket
string
S3-compatible bucket for publishing checkpoints.
s3_region
string
S3 region (optional).
s3_endpoint_url
string
Custom S3 endpoint URL (for non-AWS providers).
s3_base_path
string
Parent prefix inside the bucket. The job id is appended by the publisher (defaults to cog/ideogram4).
s3_public_base_url
string
Public base URL to build shareable links (optional).
s3_access_key
string
S3 access key (leave blank to use IAM/instance roles).
s3_secret_key
string
S3 secret key (leave blank to use IAM/instance roles).
hf_token
string
Hugging Face token for model or dataset access.
return_logs
boolean
True
Print the tail of debug.log.

Output schema

The shape of the response you’ll get when you run this model with an API.

Schema
{'format': 'uri', 'title': 'Output', 'type': 'string'}