# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs Dubbing Dubbing Resources API
  version: 1.0.0
extends: openapi/elevenlabs-dubbing-resources-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: 5
- target: $.paths['/v1/dubbing/{dubbing_id}/audio/{language_code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download dubbed audio for a language
      effect: read
      questions:
      - Where do I get the dubbed audio for one language once the dub is done?
      - Can I download just the Spanish audio from a finished dubbing project?
      instructions:
      - text: Download the {language_code} dubbed audio for dub {dubbing_id}.
        slots:
          language_code: path.language_code
          dubbing_id: path.dubbing_id
      - text: Get dubbed audio file of {dubbing_id} in {language_code}.
        slots:
          dubbing_id: path.dubbing_id
          language_code: path.language_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}/transcript/{language_code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dubbed language's timed transcript
      effect: read
      questions:
      - Can I get the timed transcript for one language version of a dub?
      - Which formats does the dubbed transcript come in?
      instructions:
      - text: Get the {language_code} transcript of dub {dubbing_id}.
        slots:
          language_code: path.language_code
          dubbing_id: path.dubbing_id
      - text: Fetch the transcript of dub {dubbing_id} in {language_code} as {format_type}.
        slots:
          dubbing_id: path.dubbing_id
          language_code: path.language_code
          format_type: query.format_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}/resource'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dub's segments, speakers and languages
      effect: read
      questions:
      - What segments and speakers make up a dubbing project?
      - Which language versions exist for a dub, with their segments?
      instructions:
      - text: Get the dubbing resource for dub {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      - text: List segments, speakers and language versions of {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}/resource/translate-segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Translate one segment of a dub
      effect: write
      questions:
      - Can I retranslate a single line of a dub into a target language?
      - How do I control the translation of one segment only?
      instructions:
      - text: Translate segment {segment_id} of dub {dubbing_id} into {target_lang}.
        slots:
          segment_id: requestBody.segment_id
          dubbing_id: path.dubbing_id
          target_lang: requestBody.target_lang
      - text: Redo the {target_lang} translation for segment {segment_id} in {dubbing_id}.
        slots:
          target_lang: requestBody.target_lang
          segment_id: requestBody.segment_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}/resource/dub-segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate dubbed audio for one segment
      effect: write
      questions:
      - Can I regenerate the dubbed voice for a single translated segment?
      - How do I synthesize speech for one line of a dub after fixing its translation?
      instructions:
      - text: Dub segment {segment_id} of {dubbing_id} in {language_code}.
        slots:
          segment_id: requestBody.segment_id
          dubbing_id: path.dubbing_id
          language_code: requestBody.language_code
      - text: Generate {language_code} speech for segment {segment_id} in dub {dubbing_id}.
        slots:
          language_code: requestBody.language_code
          segment_id: requestBody.segment_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'