API Evangelist conversational phrasing for OpenAI Images API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OpenAI Images API
  version: 1.0.0
extends: openapi/openai-images-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/images/edits'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit or extend an existing image with a prompt
      effect: write
      questions:
      - How do I change part of an existing picture by describing the edit?
      - Can I use a mask so only one area of my image gets repainted?
      - Is it possible to combine several source images into one edited result?
      instructions:
      - text: Edit image {image} so that {prompt}.
        slots:
          image: requestBody.image
          prompt: requestBody.prompt
      - text: Repaint only the masked area {mask} of {image} with {prompt}.
        slots:
          mask: requestBody.mask
          image: requestBody.image
          prompt: requestBody.prompt
      - text: Combine source images {images} into one edit following {prompt}.
        slots:
          images: requestBody.images
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/images/generations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an image from a text prompt
      effect: write
      questions:
      - How do I create a brand-new image from a text description?
      - Can I request several images at once in a particular size?
      - What quality and background options do I have when generating an image?
      instructions:
      - text: Generate an image of {prompt}.
        slots:
          prompt: requestBody.prompt
      - text: Create {n} images of {prompt} at {size}.
        slots:
          n: requestBody.n
          prompt: requestBody.prompt
          size: requestBody.size
      - text: Generate a {quality} quality picture of {prompt} with a {background} background.
        slots:
          quality: requestBody.quality
          prompt: requestBody.prompt
          background: requestBody.background
      method: generated
      generated: '2026-09-26'
- target: $.paths['/images/variations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create variations of an existing image
      effect: write
      questions:
      - Can I get a few alternative versions of a picture without writing a prompt?
      - Which model supports making image variations?
      instructions:
      - text: Make a variation of image {image}.
        slots:
          image: requestBody.image
      - text: Create {n} variations of {image} at {size}.
        slots:
          n: requestBody.n
          image: requestBody.image
          size: requestBody.size
      method: generated
      generated: '2026-09-26'