create-imageInput schema{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"maxLength": 32000
},
"background": {
"type": "string",
"enum": [
"transparent",
"opaque",
"auto"
]
},
"model": {
"type": "string",
"const": "gpt-image-1",
"default": "gpt-image-1"
},
"moderation": {
"type": "string",
"enum": [
"auto",
"low"
]
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"output_compression": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
]
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"auto"
],
"description": "Size of the generated images. Supports exact dimensions (1024x1024, 1536x1024, 1024x1536) or common aspect ratios (1:1, 16:9, 9:16, square, landscape, portrait, 3:2, 2:3, 4:3, 3:4) or 'auto'."
},
"user": {
"type": "string"
},
"output": {
"type": "string",
"enum": [
"base64",
"file_output"
],
"default": "base64"
},
"file_output": {
"type": "string",
"description": "Absolute path to save the image file, including the desired file extension (e.g., /path/to/image.png). If multiple images are generated (n > 1), an index will be appended (e.g., /path/to/image_1.png)."
},
"filename": {
"type": "string",
"description": "Optional descriptive filename (without extension) for saving the image. Example: 'cat-playing-football'. The AI should provide a descriptive name based on the prompt. If not provided, a timestamp will be used."
}
},
"required": [
"prompt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | | — |
edit-imageInput schema{
"type": "object",
"properties": {
"image": {
"type": "string",
"description": "Absolute image path or base64 string to edit."
},
"prompt": {
"type": "string",
"maxLength": 32000,
"description": "A text description of the desired edit. Max 32000 chars."
},
"mask": {
"type": "string",
"description": "Optional absolute path or base64 string for a mask image (png < 4MB, same dimensions as the first image). Fully transparent areas indicate where to edit."
},
"model": {
"type": "string",
"const": "gpt-image-1",
"default": "gpt-image-1"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Number of images to generate (1-10)."
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
],
"description": "Quality (high, medium, low) - only for gpt-image-1."
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"auto"
],
"description": "Size of the generated images. Supports exact dimensions (1024x1024, 1536x1024, 1024x1536) or common aspect ratios (1:1, 16:9, 9:16, square, landscape, portrait, 3:2, 2:3, 4:3, 3:4) or 'auto'."
},
"user": {
"type": "string",
"description": "Optional user identifier for OpenAI monitoring."
},
"output": {
"type": "string",
"enum": [
"base64",
"file_output"
],
"default": "base64",
"description": "Output format: base64 or file path."
},
"file_output": {
"type": "string",
"description": "Absolute path to save the output image file, including the desired file extension (e.g., /path/to/image.png). If n > 1, an index is appended."
},
"filename": {
"type": "string",
"description": "Optional descriptive filename (without extension) for saving the edited image. Example: 'cat-with-hat'. The AI should provide a descriptive name based on the edit. If not provided, a timestamp will be used."
}
},
"required": [
"image",
"prompt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | | — |