# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Firefly Services Audio and Video Text To Speech API
  version: 1.0.0
extends: openapi/adobe-suite-text-to-speech-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: 2
- target: $.paths['/v1/voices'].get
  update:
    x-apievangelist-phrasing:
      intent: List available text-to-speech voices
      effect: read
      questions:
      - Which voices can I use for text-to-speech in Firefly?
      - What voice IDs are available to my enterprise?
      instructions:
      - text: List the available speech voices.
      - text: Show me all voices I can generate speech with.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/generate-speech'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate speech audio from text
      effect: write
      questions:
      - Can I turn a written script into narration audio?
      - Does speech generation accept a pre-signed URL to a transcript instead of plain text?
      instructions:
      - text: Generate speech of {script} with voice {voice} and save to {output}.
        slots:
          script: requestBody.script
          voice: requestBody.voiceId
          output: requestBody.output
      - text: Narrate this script {script} using voice {voice}, output to {output}.
        slots:
          script: requestBody.script
          voice: requestBody.voiceId
          output: requestBody.output
      method: generated
      generated: '2026-09-26'