← 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 path | Type | Required | Default | Canonical description |
|---|---|---|---|---|
images | section | optional | Image generation models and presets for caco image generate. | |
└ images.models | map[string, map] | optional | Image generation models keyed by name. | |
└ images.models.<model-name> | map | optional | Image model endpoint definition. | |
└ images.models.<model-name>.openai_base_url | string | optional | OpenAI-compatible base URL. | |
└ images.models.<model-name>.openai_api_key | string | optional | OpenAI API key or $ENV reference. | |
└ images.models.<model-name>.size | string | optional | 1024x1024 | Default image size. |
└ images.models.<model-name>.quality | string | optional | high | Default quality for gpt-image-* models: high, medium, low. |
└ images.presets | map[string, map] | optional | Named generation presets keyed by preset name. | |
└ images.presets.<preset-name> | map | optional | Image generation preset. | |
└ images.presets.<preset-name>.model | string | optional | Model name from images.models. | |
└ images.presets.<preset-name>.prompt | string | optional | Generation prompt string. | |
└ images.presets.<preset-name>.postprocessing | string | optional | Optional shell command for postprocessing the generated image. | |
└ images.presets.<preset-name>.prefix | string | optional | Filename prefix for generated images. | |
└ images.presets.<preset-name>.output_dir | string | optional | .cacophony/images | Output directory relative to the project checkout. |
└ images.presets.<preset-name>.quality | string | optional | Quality override for gpt-image-* models: high, medium, low. | |
└ images.presets.<preset-name>.size | string | optional | Image size override (e.g. 1024x1024, up to 3840x2160 for gpt-image-2). |