GPT Image 2.6 Sunburst API

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "description": "Output aspect ratio. Leave it unset to keep the first image's shape (1k only); pick a ratio for 2k or 4k.",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "21:9",
        "9:21",
        "2:1",
        "1:2",
        "3:1",
        "1:3",
        "5:4",
        "4:5"
      ],
      "type": "string",
      "x-ui": {
        "order": 80,
        "widget": "select"
      }
    },
    "background": {
      "default": "auto",
      "description": "Background treatment. Transparent needs PNG or WebP output.",
      "enum": [
        "auto",
        "transparent",
        "opaque"
      ],
      "type": "string",
      "x-ui": {
        "order": 50,
        "widget": "radio"
      }
    },
    "image_urls": {
      "description": "One to 16 source images, in the order your prompt refers to them. Each one adds a small charge.",
      "items": {
        "contentMediaType": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif"
        ],
        "format": "uri",
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 16,
      "minItems": 1,
      "type": "array",
      "x-ui": {
        "affects_price": true,
        "max_size_mb": 10,
        "order": 90,
        "widget": "multi-upload"
      }
    },
    "markup_url": {
      "description": "Optional transparent PNG with circles, sketches or notes drawn over the first image to show what to change, same size as that image. Cannot be combined with mask_url.",
      "format": "uri",
      "type": "string",
      "x-ui": {
        "accept": [
          "image/png"
        ],
        "affects_price": true,
        "max_size_mb": 10,
        "order": 87,
        "widget": "upload"
      }
    },
    "mask_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional PNG mask: transparent pixels mark the area to repaint in the first image, same size as that image. Cannot be combined with markup_url.",
      "format": "uri",
      "type": "string",
      "x-ui": {
        "accept": [
          "image/png"
        ],
        "affects_price": true,
        "mask": {
          "edit": "transparent",
          "source": "image_urls"
        },
        "max_size_mb": 10,
        "order": 88,
        "widget": "upload"
      }
    },
    "num_outputs": {
      "default": 1,
      "description": "How many images to return, each billed separately.",
      "maximum": 10,
      "minimum": 1,
      "type": "integer",
      "x-ui": {
        "affects_price": true,
        "order": 60,
        "step": 1,
        "widget": "slider"
      }
    },
    "output_format": {
      "default": "png",
      "description": "File format of the returned images.",
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "type": "string",
      "x-ui": {
        "order": 20,
        "widget": "select"
      }
    },
    "output_quality": {
      "description": "Compression quality for JPEG and WebP output, from 0 to 100.",
      "maximum": 100,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "order": 15,
        "step": 1,
        "widget": "slider"
      }
    },
    "prompt": {
      "description": "Say what to change and what must stay the same. Refer to the images as Image 1, Image 2 and so on.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string",
      "x-ui": {
        "order": 100,
        "reference_tokens": {
          "image_urls": "Image {index}"
        },
        "widget": "textarea"
      }
    },
    "quality": {
      "default": "medium",
      "description": "Rendering quality. Higher tiers add detail, time and cost.",
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": true,
        "order": 76,
        "widget": "select"
      }
    },
    "reasoning_effort": {
      "description": "How much the model plans the picture before drawing. Higher helps dense text and complex layouts and takes longer; the price does not change. Leave it unset for the model default (high).",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 74,
        "widget": "select"
      }
    },
    "resolution": {
      "default": "1k",
      "description": "Output size tier: 1k is about 1 megapixel, 2k about 3.7, 4k about 8.3.",
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": true,
        "order": 78,
        "widget": "radio"
      }
    }
  },
  "required": [
    "prompt",
    "image_urls"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": [
      "quality",
      "resolution"
    ]
  }
}