# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elevenlabs Text to Dialogue API
  version: 1.0.0
extends: openapi/elevenlabs-text-to-dialogue-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/text-to-dialogue'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate multi-speaker dialogue audio
      effect: write
      questions:
      - How do I create a conversation between two voices from a script?
      - Can each line of a dialogue use a different voice in one request?
      instructions:
      - text: Generate dialogue audio from segments {segments}.
        slots:
          segments: requestBody.segments
      - text: Voice the script {segments} as {output_format} using model {model_id}.
        slots:
          segments: requestBody.segments
          output_format: query.output_format
          model_id: requestBody.model_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/text-to-dialogue/with-timestamps'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate dialogue audio with word timings
      effect: write
      questions:
      - Can I get word-level timing for a multi-speaker dialogue?
      - How would I sync subtitles to generated dialogue audio?
      instructions:
      - text: Generate dialogue from {segments} with word timestamps.
        slots:
          segments: requestBody.segments
      - text: Create timed dialogue audio for {segments} in {output_format}.
        slots:
          segments: requestBody.segments
          output_format: query.output_format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/text-to-dialogue/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream multi-voice dialogue audio
      effect: write
      questions:
      - Can I stream a multi-voice dialogue instead of waiting for the full file?
      - Is there a zero-retention mode when streaming dialogue?
      instructions:
      - text: Stream dialogue audio for inputs {inputs}.
        slots:
          inputs: requestBody.inputs
      - text: Stream dialogue {inputs} in language {language_code} with logging {enable_logging}.
        slots:
          inputs: requestBody.inputs
          language_code: requestBody.language_code
          enable_logging: query.enable_logging
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/text-to-dialogue/stream/with-timestamps'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream dialogue audio with timestamps
      effect: write
      questions:
      - Can I stream dialogue as base64 audio chunks with timestamps?
      - What's the way to get live timing data while dialogue audio streams?
      instructions:
      - text: Stream dialogue with timestamps for inputs {inputs}.
        slots:
          inputs: requestBody.inputs
      - text: Stream timed dialogue chunks for {inputs} using seed {seed}.
        slots:
          inputs: requestBody.inputs
          seed: requestBody.seed
      method: generated
      generated: '2026-09-26'