# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elevenlabs Audio Isolation API
  version: 1.0.0
extends: openapi/elevenlabs-audio-isolation-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: 4
- target: $.paths['/v1/audio-isolation'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove background noise from audio
      effect: write
      questions:
      - Can I clean up a noisy recording so only the voice remains?
      - How do I strip background noise from a podcast file with ElevenLabs?
      instructions:
      - text: Remove the background noise from {audio}.
        slots:
          audio: requestBody.audio
      - text: Isolate the vocals in {audio} and return the cleaned file.
        slots:
          audio: requestBody.audio
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-isolation/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove background noise and stream the result
      effect: write
      questions:
      - Can I stream the denoised audio back while a large file is processed?
      - Is there a chunked version of voice isolation for long recordings?
      instructions:
      - text: Stream a noise-free version of {audio}.
        slots:
          audio: requestBody.audio
      - text: Isolate the voice in large file {audio} with a streamed response.
        slots:
          audio: requestBody.audio
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-isolation/history'].get
  update:
    x-apievangelist-phrasing:
      intent: List my past audio isolation jobs
      effect: read
      questions:
      - Which files have I run through voice isolation before?
      - Can I search my audio isolation history?
      instructions:
      - text: List my audio isolation history.
      - text: Search my audio isolation history for {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-isolation/history/{history_item_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an audio isolation history item
      effect: destructive
      questions:
      - How do I delete a past noise-removal job and its files?
      - Does removing an isolation history item delete the media too?
      instructions:
      - text: Delete audio isolation history item {history_item_id}.
        slots:
          history_item_id: path.history_item_id
      - text: Remove isolation job {history_item_id} and its media files.
        slots:
          history_item_id: path.history_item_id
      method: generated
      generated: '2026-09-26'