Creative
Beta

creative_stt_transcribe

Start a transcription job for a public audio file in the connected workspace.

Operation

Write. Requires read-and-write OAuth consent.

Parameters

ParameterTypeRequiredDescription
body.audio_urlstringYesPublic HTTPS audio URL. Keep it available until the job completes.
body.language_codestringNoLanguage hint. Scribe detects the language when omitted.
body.segmentation.modestringNoUse sentence for timestamped sentence segments.
body.segmentation.boundary_lead_msintegerNoExtra time after a sentence’s final word, 0 to 500 ms. Defaults to 70.
body.modestringNoUse async to receive a job immediately.
idempotency_keystringYesReuse the key to retry the same input.
approval_receiptstringNoPlan receipt to submit after confirmation.

The server measures the audio and bills per started minute. Download the complete text, timed words, and requested sentence segments from the JSON file in data.result.artifacts. Large transcripts include a short text preview in the job result.

After confirming the plan, resubmit with its approval_receipt. Pass data.job.id to creative_jobs_wait, then retrieve the output with creative_jobs_result.

Sample prompt

Transcribe this Japanese audio into sentences and give me the transcript JSON URL.