← Schema index / Config Reference

images schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Image generation models and presets for caco image generate.

Field pathTypeRequiredDefaultCanonical description
imagessectionoptionalImage generation models and presets for caco image generate.
└ images.modelsmap[string, map]optionalImage generation models keyed by name.
└ images.models.<model-name>mapoptionalImage model endpoint definition.
└ images.models.<model-name>.openai_base_urlstringoptionalOpenAI-compatible base URL.
└ images.models.<model-name>.openai_api_keystringoptionalOpenAI API key or $ENV reference.
└ images.models.<model-name>.sizestringoptional1024x1024Default image size.
└ images.models.<model-name>.qualitystringoptionalhighDefault quality for gpt-image-* models: high, medium, low.
└ images.presetsmap[string, map]optionalNamed generation presets keyed by preset name.
└ images.presets.<preset-name>mapoptionalImage generation preset.
└ images.presets.<preset-name>.modelstringoptionalModel name from images.models.
└ images.presets.<preset-name>.promptstringoptionalGeneration prompt string.
└ images.presets.<preset-name>.postprocessingstringoptionalOptional shell command for postprocessing the generated image.
└ images.presets.<preset-name>.prefixstringoptionalFilename prefix for generated images.
└ images.presets.<preset-name>.output_dirstringoptional.cacophony/imagesOutput directory relative to the project checkout.
└ images.presets.<preset-name>.qualitystringoptionalQuality override for gpt-image-* models: high, medium, low.
└ images.presets.<preset-name>.sizestringoptionalImage size override (e.g. 1024x1024, up to 3840x2160 for gpt-image-2).