# 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 API
  version: 1.0.0
extends: openapi/elevenlabs-dubbing-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: 37
- target: $.paths['/v1/dubbing'].get
  update:
    x-apievangelist-phrasing:
      intent: List my dubs
      effect: read
      questions:
      - Which of my dubs are still in progress and which have finished?
      - Can I filter my dubs by target language or by who created them?
      instructions:
      - text: List all the dubs I have access to, newest first.
      - text: Show my dubs with status {dubbing_status}.
        slots:
          dubbing_status: query.dubbing_status
      - text: List dubs that target language {target_language_codes}.
        slots:
          target_language_codes: query.target_language_codes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing'].post
  update:
    x-apievangelist-phrasing:
      intent: Dub a video or audio file into another language
      effect: write
      questions:
      - How do I dub a video into Spanish with ElevenLabs?
      - Can I dub a file straight from a URL instead of uploading it?
      - Is it possible to tell the dubber how many speakers are in my recording?
      instructions:
      - text: Dub the video at {source_url} into {target_lang}.
        slots:
          source_url: requestBody.source_url
          target_lang: requestBody.target_lang
      - text: Dub my uploaded file {file} from {source_lang} to {target_lang} and name it {name}.
        slots:
          file: requestBody.file
          source_lang: requestBody.source_lang
          target_lang: requestBody.target_lang
          name: requestBody.name
      - text: Start a dub of {source_url} into {target_lang} with {num_speakers} speakers.
        slots:
          source_url: requestBody.source_url
          target_lang: requestBody.target_lang
          num_speakers: requestBody.num_speakers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a dub
      effect: read
      questions:
      - Is my dub finished processing yet?
      - What languages are available on a dub I already started?
      instructions:
      - text: Get the status and metadata of dub {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      - text: Check whether dub {dubbing_id} is done.
        slots:
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dub
      effect: destructive
      questions:
      - How do I permanently delete a dub and its files?
      - Can a deleted dub be recovered afterwards?
      instructions:
      - text: Delete dub {dubbing_id} and everything attached to it.
        slots:
          dubbing_id: path.dubbing_id
      - text: Remove the dub {dubbing_id} for good.
        slots:
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project'].get
  update:
    x-apievangelist-phrasing:
      intent: List dubbing projects in my workspace
      effect: read
      questions:
      - What dubbing projects exist in my workspace?
      - Can I list only the dubbing projects that are ready?
      instructions:
      - text: List the dubbing projects in my workspace, newest first.
      - text: Show dubbing projects with project status {status}.
        slots:
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a dubbing project from a file or URL
      effect: write
      questions:
      - How do I set up a dubbing project I can add languages to later?
      - Can I give the dubbing project key terms so names are transcribed correctly?
      - Does creating a dubbing project wait until the source is processed?
      instructions:
      - text: Create a dubbing project from {source_url} in source language {source_language}.
        slots:
          source_url: requestBody.source_url
          source_language: requestBody.source_language
      - text: Create a dubbing project from my file {file} and notify webhooks {webhook_ids} when it is ready.
        slots:
          file: requestBody.file
          webhook_ids: requestBody.webhook_ids
      - text: Set up a dubbing project for {source_url} with key terms {keyterms}.
        slots:
          source_url: requestBody.source_url
          keyterms: requestBody.keyterms
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dubbing project's details
      effect: read
      questions:
      - Which language targets are under my dubbing project?
      - Has my dubbing project reached the ready state?
      instructions:
      - text: Get the full details of dubbing project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show the language target IDs under dubbing project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dubbing project and all its languages
      effect: destructive
      questions:
      - Am I still billed if I delete a dubbing project while a dub is running?
      - What gets removed when I delete a whole dubbing project?
      instructions:
      - text: Delete dubbing project {project_id} with all its language targets and outputs.
        slots:
          project_id: path.project_id
      - text: Permanently remove dubbing project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language'].get
  update:
    x-apievangelist-phrasing:
      intent: List a dubbing project's language targets
      effect: read
      questions:
      - Which languages is my dubbing project being dubbed into?
      - Where do I find the download URLs for each dubbed language of a project?
      instructions:
      - text: List the language targets of dubbing project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show language targets in project {project_id} with status {status}.
        slots:
          project_id: path.project_id
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to a dubbing project and dub it
      effect: write
      questions:
      - How do I dub an existing dubbing project into one more language?
      - Is adding a language target to a project billed as a generation?
      instructions:
      - text: Dub project {project_id} into {target_language}.
        slots:
          project_id: path.project_id
          target_language: requestBody.target_language
      - text: Add target language {target_language} to project {project_id} using voice settings {voice_settings}.
        slots:
          target_language: requestBody.target_language
          project_id: path.project_id
          voice_settings: requestBody.voice_settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one language target of a dubbing project
      effect: read
      questions:
      - Is the French version of my dubbing project completed yet?
      - Where are the signed output URLs for a single dubbed language target?
      instructions:
      - text: Get language target {language_id} of dubbing project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      - text: Fetch the output download links for language {language_id} in project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one language from a dubbing project
      effect: destructive
      questions:
      - Can I drop one dubbed language without deleting the whole project?
      - Does removing a language target delete its outputs too?
      instructions:
      - text: Delete language target {language_id} from dubbing project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      - text: Remove the {language_id} dub and its outputs from project {project_id}, keeping the other languages.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/transcript'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dubbing project's source transcript
      effect: read
      questions:
      - Can I see the original-language transcript of my dubbing project as segments?
      - When does the source transcript of a dubbing project become available?
      instructions:
      - text: Get the source transcript segments of dubbing project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show me what was transcribed from the source media in project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/transcript/segment/{segment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a source transcript segment
      effect: destructive
      questions:
      - How can I stop one line of the source transcript from being dubbed?
      - What happens to translations when I delete a source segment?
      instructions:
      - text: Delete source segment {segment_id} from the transcript of project {project_id}.
        slots:
          segment_id: path.segment_id
          project_id: path.project_id
      - text: Remove segment {segment_id} so project {project_id} no longer dubs it.
        slots:
          segment_id: path.segment_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/transcript/segment/{segment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit one source transcript segment
      effect: write
      questions:
      - Can I fix a typo in one line of the source transcript before dubbing?
      - Is it possible to change which speaker a source segment belongs to or its timing?
      instructions:
      - text: Change the text of source segment {segment_id} in project {project_id} to {text}.
        slots:
          segment_id: path.segment_id
          project_id: path.project_id
          text: requestBody.text
      - text: Retime source segment {segment_id} in project {project_id} to run from {start_s} to {end_s} seconds.
        slots:
          segment_id: path.segment_id
          project_id: path.project_id
          start_s: requestBody.start_s
          end_s: requestBody.end_s
      - text: Reassign source segment {segment_id} of project {project_id} to speaker {speaker_id}.
        slots:
          segment_id: path.segment_id
          project_id: path.project_id
          speaker_id: requestBody.speaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/transcript/segments'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit several source transcript segments at once
      effect: write
      questions:
      - Can I edit many source transcript lines in a single all-or-nothing request?
      - What happens if one edit in a bulk source-segment update is invalid?
      instructions:
      - text: Apply these source segment edits {segments} to project {project_id} atomically.
        slots:
          segments: requestBody.segments
          project_id: path.project_id
      - text: Bulk update the source transcript of project {project_id} with {segments}.
        slots:
          project_id: path.project_id
          segments: requestBody.segments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/transcript/segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new segment to a source transcript
      effect: write
      questions:
      - How do I add a line the transcription missed to my dubbing project?
      - How long can a newly added source segment be?
      instructions:
      - text: Add a source segment to project {project_id} saying {text} for speaker {speaker_id} from {start_s} to {end_s} seconds.
        slots:
          project_id: path.project_id
          text: requestBody.text
          speaker_id: requestBody.speaker_id
          start_s: requestBody.start_s
          end_s: requestBody.end_s
      - text: Insert missing line {text} into the source transcript of project {project_id} between {start_s} and {end_s}s, spoken by {speaker_id}.
        slots:
          text: requestBody.text
          project_id: path.project_id
          start_s: requestBody.start_s
          end_s: requestBody.end_s
          speaker_id: requestBody.speaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}/transcript'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dubbed language's translated transcript
      effect: read
      questions:
      - Can I review the translations side by side with the source for one dubbed language?
      - Why does fetching a language target's transcript return a conflict?
      instructions:
      - text: Get the translated transcript for language {language_id} of project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      - text: Show source segments with their {language_id} translations in project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}/transcript/segment/{segment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit one segment's translation for a language
      effect: write
      questions:
      - Can I correct a single translated line in one dubbed language?
      - Does sending null clear a segment's translation?
      instructions:
      - text: Set the translation of segment {segment_id} in language {language_id} of project {project_id} to {translation}.
        slots:
          segment_id: path.segment_id
          language_id: path.language_id
          project_id: path.project_id
          translation: requestBody.translation
      - text: Clear the translation of segment {segment_id} for target {language_id} in project {project_id}.
        slots:
          segment_id: path.segment_id
          language_id: path.language_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit several translations for a language at once
      effect: write
      questions:
      - Can I update many translated lines of one dubbed language in one atomic call?
      - Which dubbing call lets me batch-edit translations rather than source text?
      instructions:
      - text: Apply translation edits {segments} to language {language_id} of project {project_id}.
        slots:
          segments: requestBody.segments
          language_id: path.language_id
          project_id: path.project_id
      - text: Bulk update the {language_id} translations in project {project_id} with {segments}, all or nothing.
        slots:
          language_id: path.language_id
          project_id: path.project_id
          segments: requestBody.segments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/project/{project_id}/language/{language_id}/transcript/regenerate'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-dub a language from its edited transcript
      effect: write
      questions:
      - After editing translations, how do I get new dubbed audio for just the changed parts?
      - Is re-dubbing an edited language target charged?
      instructions:
      - text: Regenerate the dub for language {language_id} of project {project_id} from its edited transcript.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      - text: Re-synthesize the edited regions of target {language_id} in project {project_id}.
        slots:
          language_id: path.language_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dubbing Studio resource
      effect: read
      questions:
      - How do I load the Dubbing Studio resource for a studio-enabled dub?
      - What speakers and segments are in my Dubbing Studio resource?
      instructions:
      - text: Get the Dubbing Studio resource for dub {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      - text: Show the speakers, segments and languages of studio dub {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/language'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to a Dubbing Studio resource
      effect: write
      questions:
      - Can I add another language to a studio dub without generating audio right away?
      - Which language codes can be added to a Dubbing Studio resource?
      instructions:
      - text: Add language {language} to studio dub {dubbing_id}.
        slots:
          language: requestBody.language
          dubbing_id: path.dubbing_id
      - text: Register {language} as a new language on Dubbing Studio resource {dubbing_id}.
        slots:
          language: requestBody.language
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a segment for a speaker in a studio dub
      effect: write
      questions:
      - How do I add a new timed segment for one speaker in Dubbing Studio?
      - Does creating a studio segment automatically translate or dub it?
      instructions:
      - text: Create a segment for speaker {speaker_id} in studio dub {dubbing_id} from {start_time} to {end_time}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
      - text: Add a segment with text {text} for speaker {speaker_id} in dub {dubbing_id} between {start_time} and {end_time}.
        slots:
          text: requestBody.text
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a studio segment for one language
      effect: write
      questions:
      - Can I change a studio segment's text in just one language?
      - Is it possible to shift the start and end time of a segment for a single language?
      instructions:
      - text: Update segment {segment_id} in language {language} of studio dub {dubbing_id} to read {text}.
        slots:
          segment_id: path.segment_id
          language: path.language
          dubbing_id: path.dubbing_id
          text: requestBody.text
      - text: Move segment {segment_id} for {language} in dub {dubbing_id} to start at {start_time} and end at {end_time}.
        slots:
          segment_id: path.segment_id
          language: path.language
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/migrate-segments'].post
  update:
    x-apievangelist-phrasing:
      intent: Move segments to a different speaker
      effect: write
      questions:
      - The dub attributed lines to the wrong person, how do I reassign them?
      - Can I move several studio segments to another speaker at once?
      instructions:
      - text: Move segments {segment_ids} in studio dub {dubbing_id} to speaker {speaker_id}.
        slots:
          segment_ids: requestBody.segment_ids
          dubbing_id: path.dubbing_id
          speaker_id: requestBody.speaker_id
      - text: Reattribute segments {segment_ids} of dub {dubbing_id} to {speaker_id}.
        slots:
          segment_ids: requestBody.segment_ids
          dubbing_id: path.dubbing_id
          speaker_id: requestBody.speaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a segment from a studio dub
      effect: destructive
      questions:
      - How do I delete an unwanted segment in Dubbing Studio?
      - Can I remove one segment from a studio dub across all its languages?
      instructions:
      - text: Delete segment {segment_id} from studio dub {dubbing_id}.
        slots:
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
      - text: Remove studio segment {segment_id} in dub {dubbing_id}.
        slots:
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/transcribe'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-transcribe segments in a studio dub
      effect: write
      questions:
      - Can I redo the transcription of specific segments in Dubbing Studio?
      - Will re-transcribing studio segments also update their translations?
      instructions:
      - text: Re-transcribe segments {segments} in studio dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      - text: Regenerate the transcription for {segments} on dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/translate'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate translations in a studio dub
      effect: write
      questions:
      - How do I refresh the translations for some segments and languages in Dubbing Studio?
      - Does regenerating studio translations transcribe missing segments first?
      instructions:
      - text: Re-translate segments {segments} into {languages} for studio dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Regenerate translations of dub {dubbing_id} for languages {languages} on segments {segments}.
        slots:
          dubbing_id: path.dubbing_id
          languages: requestBody.languages
          segments: requestBody.segments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/dub'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate dubbed audio in a studio dub
      effect: write
      questions:
      - After fixing translations in Dubbing Studio, how do I regenerate the dubbed voice audio?
      - Will re-dubbing studio segments fill in missing transcriptions and translations?
      instructions:
      - text: Re-dub segments {segments} in languages {languages} for studio dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Regenerate the voice audio of dub {dubbing_id} for {languages} on {segments}.
        slots:
          dubbing_id: path.dubbing_id
          languages: requestBody.languages
          segments: requestBody.segments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a studio speaker's name or voice
      effect: write
      questions:
      - Can I swap the voice used for one speaker in a studio dub?
      - What voice stability and similarity settings can I set per dubbing speaker?
      instructions:
      - text: Set speaker {speaker_id} in studio dub {dubbing_id} to use voice {voice_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      - text: Rename speaker {speaker_id} in dub {dubbing_id} to {speaker_name}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          speaker_name: requestBody.speaker_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new speaker to a studio dub
      effect: write
      questions:
      - How do I add a speaker that the automatic dub did not detect?
      - Can a new studio speaker be linked to one of my voices from the start?
      instructions:
      - text: Create a speaker named {speaker_name} in studio dub {dubbing_id}.
        slots:
          speaker_name: requestBody.speaker_name
          dubbing_id: path.dubbing_id
      - text: Add a new speaker to dub {dubbing_id} voiced by {voice_id}.
        slots:
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/similar-voices'].get
  update:
    x-apievangelist-phrasing:
      intent: Find library voices similar to a dub speaker
      effect: read
      questions:
      - Which library voices sound most like a speaker in my dub?
      - Can I hear samples of voices that resemble the original speaker?
      instructions:
      - text: Find the top 10 library voices similar to speaker {speaker_id} in dub {dubbing_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      - text: Suggest replacement voices that match speaker {speaker_id} of studio dub {dubbing_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/render/{language}'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a studio dub's audio or video for a language
      effect: write
      questions:
      - How do I export the final video after editing a dub in Dubbing Studio?
      - Can I normalize volume when rendering a studio dub?
      instructions:
      - text: Render studio dub {dubbing_id} in {language} as {render_type}.
        slots:
          dubbing_id: path.dubbing_id
          language: path.language
          render_type: requestBody.render_type
      - text: Export the {language} {render_type} of dub {dubbing_id} with volume normalization {normalize_volume}.
        slots:
          language: path.language
          render_type: requestBody.render_type
          dubbing_id: path.dubbing_id
          normalize_volume: requestBody.normalize_volume
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/{dubbing_id}/audio/{language_code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a dubbed MP3 or MP4 file
      effect: read
      questions:
      - Where do I download the finished dubbed video for a language?
      - Why doesn't the downloaded dub include my Dubbing Studio edits?
      instructions:
      - text: Download the {language_code} dubbed file for dub {dubbing_id}.
        slots:
          language_code: path.language_code
          dubbing_id: path.dubbing_id
      - text: Stream the dubbed media 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: Download a dub's subtitles as SRT or WebVTT
      effect: read
      questions:
      - Can I get subtitles for my dubbed video as an SRT file?
      - Does the dubbed transcript download support WebVTT?
      instructions:
      - text: Download the {language_code} subtitles of dub {dubbing_id} as {format_type}.
        slots:
          language_code: path.language_code
          dubbing_id: path.dubbing_id
          format_type: query.format_type
      - text: Get the SRT transcript file for dub {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}/transcripts/{language_code}/format/{format_type}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a dub's transcript in a chosen format
      effect: read
      questions:
      - What transcript formats can I retrieve for one language of a dub?
      - Can I choose srt, webvtt or json as the format of one dubbed language's transcript?
      instructions:
      - text: Retrieve the {language_code} transcript of dub {dubbing_id} in format {format_type} via the format path.
        slots:
          language_code: path.language_code
          dubbing_id: path.dubbing_id
          format_type: path.format_type
      - text: Fetch transcript format {format_type} for language {language_code} on dub {dubbing_id}.
        slots:
          format_type: path.format_type
          language_code: path.language_code
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'