# 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 Avatar API
  version: 1.0.0
extends: openapi/adobe-suite-text-to-avatar-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['/v1/voices'].get
  update:
    x-apievangelist-phrasing:
      intent: List available avatar voices
      effect: read
      questions:
      - Which voices can my enterprise use for avatar videos?
      - What voice options are available for text-to-avatar?
      instructions:
      - text: List the available voices.
      - text: Show every voice my enterprise can use.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/avatars'].get
  update:
    x-apievangelist-phrasing:
      intent: List available avatars
      effect: read
      questions:
      - Which avatars can I use to present a video?
      - What avatar characters does my enterprise have access to?
      instructions:
      - text: List the available avatars.
      - text: Show all avatars my enterprise can use.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/generate-avatar'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an avatar video from text
      effect: write
      questions:
      - How do I turn a script into a talking avatar video?
      - Can I drive an avatar video from an audio file instead of text?
      instructions:
      - text: Generate an avatar video from my transcript.
      - text: Create an avatar video using a pre-signed audio file URL.
      method: generated
      generated: '2026-09-26'