API Evangelist conversational phrasing for ElevenLabs API Documentation Flows API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs API Documentation Flows API
  version: 1.0.0
extends: openapi/elevenlabs-flows-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: 9
- target: $.paths['/v1/flows/video'].get
  update:
    x-apievangelist-phrasing:
      intent: List my video generations
      effect: read
      questions:
      - Which AI video generations have I started through the API?
      - Can I filter my video generations by status or model?
      instructions:
      - text: List my video generations, newest first.
      - text: Show video generations with status {status}.
        slots:
          status: query.status
      - text: List video generations made with model {model_id}, {page_size} per page.
        slots:
          model_id: query.model_id
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/video'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a video generation
      effect: write
      questions:
      - How do I generate a video with one of the Flows models?
      - Can I kick off an AI video generation through ElevenLabs?
      instructions:
      - text: Start a new video generation.
      - text: Kick off an asynchronous video generation with the selected model.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/video/{generation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a video generation and get its URL
      effect: read
      questions:
      - Is my video generation finished yet?
      - Where do I get the output URL of a completed video generation?
      instructions:
      - text: Check the status of video generation {generation_id}.
        slots:
          generation_id: path.generation_id
      - text: Get the output URL for finished video {generation_id}.
        slots:
          generation_id: path.generation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/image'].get
  update:
    x-apievangelist-phrasing:
      intent: List my image generations
      effect: read
      questions:
      - What images have I generated through the Flows API?
      - Can I page through image generations filtered by model?
      instructions:
      - text: List my image generations.
      - text: Show image generations with status {status}.
        slots:
          status: query.status
      - text: List image generations from model {model_id}.
        slots:
          model_id: query.model_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/image'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an image generation
      effect: write
      questions:
      - Can I create images with ElevenLabs Flows?
      - How do I start generating an image with a chosen model?
      instructions:
      - text: Start a new image generation.
      - text: Kick off an image generation with the selected model.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/image/{generation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an image generation and get its URL
      effect: read
      questions:
      - Has my image generation completed?
      - How do I retrieve the finished image's output URL?
      instructions:
      - text: Check the status of image generation {generation_id}.
        slots:
          generation_id: path.generation_id
      - text: Get the output URL for image {generation_id}.
        slots:
          generation_id: path.generation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/text-to-speech'].get
  update:
    x-apievangelist-phrasing:
      intent: List my asynchronous speech generations
      effect: read
      questions:
      - Which asynchronous speech generations have I started through Flows?
      - Can I filter my Flows speech generations by lifecycle status?
      instructions:
      - text: List my Flows speech generations.
      - text: Show speech generations with status {status}.
        slots:
          status: query.status
      - text: List speech generations for model {model_id}, continuing from cursor {cursor}.
        slots:
          model_id: query.model_id
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/text-to-speech'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an asynchronous speech generation
      effect: write
      questions:
      - When should I use the asynchronous Flows speech generation instead of direct text-to-speech?
      - Can I generate speech with a model that the regular text-to-speech endpoint doesn't offer?
      instructions:
      - text: Start an asynchronous speech generation job.
      - text: Queue a Flows speech generation with the selected model.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/flows/text-to-speech/{generation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an asynchronous speech generation
      effect: read
      questions:
      - Is my queued speech generation done?
      - Where's the audio URL for a completed Flows speech generation?
      instructions:
      - text: Check the status of speech generation {generation_id}.
        slots:
          generation_id: path.generation_id
      - text: Get the audio output URL for speech generation {generation_id}.
        slots:
          generation_id: path.generation_id
      method: generated
      generated: '2026-09-26'