generate_image
Create custom images based on text prompts using AI. Specify dimensions, aspect ratio, output format, and quality. Save images to a defined path for integration with Printify's print-on-demand platform.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aspectRatio | No | Aspect ratio (e.g., '16:9', '4:3', '1:1'). If provided, overrides width and height | |
| guidanceScale | No | Guidance scale | |
| height | No | Image height in pixels | |
| imagePromptStrength | No | Image prompt strength 0-1 (Flux 1.1 Pro Ultra only) | |
| model | No | Optional: Override the default model. Use get_defaults to see available models | |
| negativePrompt | No | Negative prompt | low quality, bad quality, sketches |
| numInferenceSteps | No | Number of inference steps | |
| outputFormat | No | Output format | png |
| outputPath | Yes | Full path where the generated image should be saved | |
| outputQuality | No | Output quality 1-100 (Flux 1.1 Pro only) | |
| prompt | Yes | Text prompt for image generation | |
| promptUpsampling | No | Enable prompt upsampling (Flux 1.1 Pro only) | |
| raw | No | Generate less processed, more natural-looking images (Flux 1.1 Pro Ultra only) | |
| safetyTolerance | No | Safety tolerance (0-6) | |
| seed | No | Random seed for reproducible generation | |
| width | No | Image width in pixels |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"aspectRatio": {
"description": "Aspect ratio (e.g., '16:9', '4:3', '1:1'). If provided, overrides width and height",
"type": "string"
},
"guidanceScale": {
"default": 7.5,
"description": "Guidance scale",
"type": "number"
},
"height": {
"default": 1024,
"description": "Image height in pixels",
"type": "number"
},
"imagePromptStrength": {
"description": "Image prompt strength 0-1 (Flux 1.1 Pro Ultra only)",
"type": "number"
},
"model": {
"description": "Optional: Override the default model. Use get_defaults to see available models",
"type": "string"
},
"negativePrompt": {
"default": "low quality, bad quality, sketches",
"description": "Negative prompt",
"type": "string"
},
"numInferenceSteps": {
"default": 25,
"description": "Number of inference steps",
"type": "number"
},
"outputFormat": {
"default": "png",
"description": "Output format",
"enum": [
"jpeg",
"png",
"webp"
],
"type": "string"
},
"outputPath": {
"description": "Full path where the generated image should be saved",
"type": "string"
},
"outputQuality": {
"description": "Output quality 1-100 (Flux 1.1 Pro only)",
"type": "number"
},
"prompt": {
"description": "Text prompt for image generation",
"type": "string"
},
"promptUpsampling": {
"description": "Enable prompt upsampling (Flux 1.1 Pro only)",
"type": "boolean"
},
"raw": {
"description": "Generate less processed, more natural-looking images (Flux 1.1 Pro Ultra only)",
"type": "boolean"
},
"safetyTolerance": {
"default": 2,
"description": "Safety tolerance (0-6)",
"type": "number"
},
"seed": {
"description": "Random seed for reproducible generation",
"type": "number"
},
"width": {
"default": 1024,
"description": "Image width in pixels",
"type": "number"
}
},
"required": [
"prompt",
"outputPath"
],
"type": "object"
}