Skip to main content

Transcribe Clip Project Item

Category: Pr Bins & Project Items Transcribe Clip Project Item block screenshot

Starts transcription for one clip project item. Sequence project items are rejected. An omitted or blank languageCode uses Premiere's default. An explicit code is trimmed and its pack must be available. storeResultIn is true for ALREADY_PRESENT or TRANSCRIBED. ALREADY_PRESENT only confirms presence; it does not wait for an existing incomplete transcript. TRANSCRIBED means this invocation's Adobe Promise completed successfully. Native false and non-stopping errors set result=false and outcome to an empty string. Use distinct output variables; aliasing both outputs is an invalid configuration and always stops, regardless of onError. Pending grouped Actions are committed before the clip is resolved and transcription begins. Their changes remain committed if transcription fails. Cancellation is cooperative after the native Promise settles. Requires Premiere write permission for the clip. Prefer asynchronous DSL runs for long jobs, then export and validate transcript content before semantic use.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpressionreference, string—
languageCodenoexpressionstring—
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-namevariable-name—
storeOutcomeInnovariable-namevariable-name—

Notes​

  • Transcribes one clip project item; Sequence project items are rejected.
  • Omitted or blank languageCode uses Premiere's transcription preferences. Explicit codes are trimmed and preflighted with isLanguagePackAvailable, then mapped to the native language option (the public DSL field remains languageCode). According to Adobe's clarification, this selects the recognition language, not just transcript metadata: enabled preference auto-detection overrides the API option; otherwise the explicit option overrides the default language. Disable auto-detection when testing an explicit language. Live-verified on Windows Beta 27.0: with auto-detection off and English default, explicit de-DE produced correct German content/de-de while omission produced inaccurate English-mode content/en-us. Exact 26.5, macOS and enabled-auto-detection precedence with the corrected key remain unverified.
  • storeResultIn=true with storeOutcomeIn=ALREADY_PRESENT confirms existence only. It does not wait for an already-running or incomplete transcript. TRANSCRIBED means the newly started Adobe Promise resolved true.
  • Native false and non-stopping errors leave result false and outcome ""; use different variables for these outputs. Reusing one variable for both outputs is an invalid block configuration and always stops, even under CONTINUE or RETURN_FALSE. Export and validate content before semantic use.
  • The handler commits pending Actions before resolving the clip, including in MANUAL_GROUPED. Earlier changes remain committed if transcription fails. Cancellation takes effect after the native Promise settles.
  • Requires clip-scoped Premiere write permission. Long jobs can outlast synchronous client timeouts; use the execution surface's supported long-running workflow.

Examples​

Transcribe Selected Clips

Transcribe explicitly selected clip project items, distinguish existing transcripts, and export JSON for content review.

kind: Pattern · format: runtime-dsl · validation: Manual workspace

Topics: transcript, selection

Source: patterns/ex-transcribe-selected-clips.json

Download JSON