v1

latestOpenAPI 3.0.42026-07-2271315.1 KB
Transcription API

Submit Audio for Transcription

Submit an audio file for transcription. Pass the pre-signed download URL returned by complete-upload. Transcription runs asynchronously — use the returned transcription_id to poll for results.

post/open/partner/ai/transcriptions/

Headers

Content-Typestring required

Request body

file_urlstring required

Pre-signed download URL returned by complete-upload (M4A, MP3, WAV).

Response

Transcription task accepted

transcription_idstring

Identifier used to poll for results.

status'PENDING' | 'RECEIVED' | 'STARTED' | 'PROGRESS' | 'SUCCESS' | 'FAILURE' | 'REVOKED'

PENDING, RECEIVED, STARTED, PROGRESS indicate the task is in progress — keep polling. SUCCESS means the data is ready. FAILURE and REVOKED are terminal failures.

dataobject

Empty until the transcription completes.

Example response

{
  "transcription_id": "task_exec_xxx",
  "status": "PENDING"
}