# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Firefly Composite Operations API
  version: 1.0.0
extends: openapi/adobe-suite-composite-operations-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['/v3/images/generate-object-composite-async'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a scene around a product image
      effect: write
      questions:
      - Can Firefly place my product photo into a generated scene from a text prompt?
      - What conditions must my image meet, like a transparent layer or a mask, for a composite to work?
      - How many composite variations can I request at once?
      instructions:
      - text: Generate a scene around image {image} described as {prompt}.
        slots:
          image: requestBody.image
          prompt: requestBody.prompt
      - text: Create {count} composite variations of image {image} with prompt {prompt} at size {size}.
        slots:
          count: requestBody.numVariations
          image: requestBody.image
          prompt: requestBody.prompt
          size: requestBody.size
      - text: Composite image {image} using mask {mask} into a scene of {prompt}.
        slots:
          image: requestBody.image
          mask: requestBody.mask
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/images/precise-composite'].post
  update:
    x-apievangelist-phrasing:
      intent: Blend an object onto a background precisely
      effect: write
      questions:
      - How do I paste an object onto a background image while keeping its original look?
      - Can I control how much the object is harmonized versus preserved?
      instructions:
      - text: Precisely composite object {object} onto background {background}.
        slots:
          object: requestBody.object
          background: requestBody.background
      - text: Place object {object} on background {background} with blend {blend}.
        slots:
          object: requestBody.object
          background: requestBody.background
          blend: requestBody.blend
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/images/adaptive-composite'].post
  update:
    x-apievangelist-phrasing:
      intent: Adaptively composite an object into a scene
      effect: write
      questions:
      - Can the object's lighting and colors be adjusted to match the background?
      - Is there a way to reduce shadows in an adaptive composite?
      instructions:
      - text: Adaptively composite object {object} into background {background}.
        slots:
          object: requestBody.object
          background: requestBody.background
      - text: Composite {object} into {background} with harmonization {harmonization} and shadow intensity {shadow}.
        slots:
          object: requestBody.object
          background: requestBody.background
          harmonization: requestBody.harmonization
          shadow: requestBody.shadowIntensity
      method: generated
      generated: '2026-09-26'