# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elevenlabs Speech to Speech API
  version: 1.0.0
extends: openapi/elevenlabs-speech-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/speech-to-speech/{voice_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Change the voice in an audio recording
      effect: write
      questions:
      - Can I make my recording sound like a different voice while keeping the delivery?
      - Which audio formats can I upload to the voice changer?
      instructions:
      - text: Convert {audio} to voice {voice_id}.
        slots:
          audio: requestBody.audio
          voice_id: path.voice_id
      - text: Re-voice {audio} as {voice_id} and return {output_format}.
        slots:
          audio: requestBody.audio
          voice_id: path.voice_id
          output_format: query.output_format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/speech-to-speech/{voice_id}/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream voice-changed audio
      effect: write
      questions:
      - Can the voice changer stream its output for real-time playback?
      - How do I get converted voice audio in chunks as it's processed?
      instructions:
      - text: Stream {audio} converted to voice {voice_id}.
        slots:
          audio: requestBody.audio
          voice_id: path.voice_id
      - text: Stream a voice-changed version of {audio} as {voice_id} using model {model_id}.
        slots:
          audio: requestBody.audio
          voice_id: path.voice_id
          model_id: requestBody.model_id
      method: generated
      generated: '2026-09-26'