Skip to main content
POST
cURL
Step 2 of 2 for transcribing your own file. Registers the object you uploaded via Get Upload URL as a project and starts processing. The response returns immediately; poll Get Project or use a webhook — see Lifecycle & Polling.

Request

Send x-tt-source: <your-app> if you want the project attributed to your integration in analytics; it defaults to web.

Response

The created project. Its state starts at upload and advances to transcription, then done.

Example

cURL

Authorizations

api-key
string
header
required

Body

application/json
name
string
required

Display name for the project

fileUrl
string
required

https://videoven-data.s3.amazonaws.com/{key}::{key}, using the key from /api/upload-url in both halves

videoLength
integer
required

Duration in seconds; used to reserve credit

language
string

Language code such as en or tr; defaults to auto-detect

webhookUrl
string

URL that receives a POST when transcription completes

Response

Project created and queued for transcription

Returned when state is 'upload' or 'transcription'

id
string<uuid>
name
string
state
enum<string>
Available options:
upload,
transcription
message
string
Example:

"Transcription is in progress"

videoLength
integer

Length in seconds

createdAt
string<date-time>