Create transcript job | Resemble

Submit audio or video for transcription

Authentication

AuthorizationBearer

API token from https://app.resemble.ai/account/api

Request

This endpoint expects a multipart form containing an optional file.

filefileOptional

Audio or video file (max 500 MB, 20 minutes)

querystringOptional

Optional intelligence question to evaluate after transcription

callback_urlstringOptionalformat: "uri"

Public HTTPS URL that receives a POST with the result when processing finishes. Private, loopback, link-local, and non-HTTPS URLs are rejected. Required when zero_retention_mode is true.

zero_retention_modebooleanOptionalDefaults to false

Enable zero retention. The uploaded media and any temporary processing copies are permanently deleted after transcription, and the transcript content is purged after one delivery to callback_url (which is mandatory in this mode). privacy_mode is accepted as an alias. Plan feature — requests are rejected with 402 if not included in your plan.

Response

Transcript job created

successboolean

itemobject

Errors

400

Bad Request Error

402

Payment Required Error

$	curl -X POST https://app.resemble.ai/api/v2/speech-to-text \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@<file1>

1	{
2	"success": true,
3	"item": {
4	"uuid": "string",
5	"status": "pending",
6	"privacy_mode": true,
7	"created_at": "2024-01-15T09:30:00Z",
8	"updated_at": "2024-01-15T09:30:00Z"
9	}
10	}