POST
/
api
/
v1
/
transcribe
/
url
Create Transcription Job From Url
curl --request POST \
  --url https://api.fennec-asr.com/api/v1/transcribe/url \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "audio": "https://filesamples.com/samples/audio/mp3/sample-3.mp3",
  "context": "<string>",
  "formatting": {
    "newline_pause_threshold": 0.8,
    "double_newline_pause_threshold": 1.5
  },
  "apply_contextual_correction": true
}'
{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "queued",
  "detail": "Your transcription job has been successfully queued."
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Defines the request body for the non-streaming transcription endpoint. Accepts an audio source as a URL or a data URI.

​
audio
required

A publicly accessible URL to an audio file OR a base64-encoded data URI.

Minimum length: 1
Examples:

"https://filesamples.com/samples/audio/mp3/sample-3.mp3"

"data:audio/mp3;base64,SUQz..."

​
context
string | null

Optional context to guide the ASR model. Doubles cost and increases latency.

Maximum length: 1000
​
formatting
object | null

Rules for applying formatting to the final transcript based on detected pauses. Defines formatting options for the final transcript based on pause lengths.

​
apply_contextual_correction
boolean | null
default:false

If true, performs an additional AI pass to correct contextual errors. Requires 'context' to be effective.

Response

Successful Response

Response model when a non-streaming job is successfully queued.

​
job_id
string<uuid>
required
​
status
string
default:queued
​
detail
string
default:Your transcription job has been successfully queued.