Transcriptions — Submit Job
curl --request POST \
--url https://api.linqalpha.com/v2/transcriptions \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"upload_id": "8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90",
"target_language": "en"
}
'import requests
url = "https://api.linqalpha.com/v2/transcriptions"
payload = {
"upload_id": "8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90",
"target_language": "en"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({upload_id: '8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90', target_language: 'en'})
};
fetch('https://api.linqalpha.com/v2/transcriptions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linqalpha.com/v2/transcriptions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'upload_id' => '8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90',
'target_language' => 'en'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linqalpha.com/v2/transcriptions"
payload := strings.NewReader("{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linqalpha.com/v2/transcriptions")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linqalpha.com/v2/transcriptions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}"
response = http.request(request)
puts response.read_body{
"error": null,
"payload": {
"job_id": "5a1d3f6e-9c2b-4e7a-8f10-6b2c3d4e5f60",
"status": "queued"
}
}Transcriptions
Transcriptions — Submit Job
Step 2. Starts STT over the uploaded recording with optional translation. Returns 202 once the job has been submitted for processing; poll GET /v2/transcriptions/. Send Idempotency-Key to make retries safe.
POST
/
v2
/
transcriptions
Transcriptions — Submit Job
curl --request POST \
--url https://api.linqalpha.com/v2/transcriptions \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"upload_id": "8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90",
"target_language": "en"
}
'import requests
url = "https://api.linqalpha.com/v2/transcriptions"
payload = {
"upload_id": "8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90",
"target_language": "en"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({upload_id: '8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90', target_language: 'en'})
};
fetch('https://api.linqalpha.com/v2/transcriptions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linqalpha.com/v2/transcriptions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'upload_id' => '8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90',
'target_language' => 'en'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linqalpha.com/v2/transcriptions"
payload := strings.NewReader("{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linqalpha.com/v2/transcriptions")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linqalpha.com/v2/transcriptions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"upload_id\": \"8d2e6c1a-4f0b-4d7e-9a3c-2b1f5e6a7c90\",\n \"target_language\": \"en\"\n}"
response = http.request(request)
puts response.read_body{
"error": null,
"payload": {
"job_id": "5a1d3f6e-9c2b-4e7a-8f10-6b2c3d4e5f60",
"status": "queued"
}
}Step 2. Starts speech-to-text over an uploaded recording, with an optional translation into
target_language. Returns 202 Accepted as soon as the job has been submitted for processing; completion is observed by polling GET /v2/transcriptions/{job_id} (the Location header points there, Retry-After suggests the cadence).
curl --request POST \
--url 'https://api.linqalpha.com/v2/transcriptions' \
--header 'X-API-KEY: <api-key>' \
--header 'Idempotency-Key: 2f1c7e4a-bam-call-001' \
--header 'Content-Type: application/json' \
--data '{"upload_id":"<upload_id>","target_language":"en"}'
Language behavior
- Omit
target_languagefor transcription only. Every spoken language is preserved andtranslated_textisnull. target_languageis a 2–3 letter ISO 639 code (en,zh,ko, …), case-insensitive. Other formats, such asen-US, are rejected with400. Every segment is sent for translation regardless of the language the speech-to-text step labelled it with; the translator is instructed to return text already in the target language unchanged and to translate the other-language parts of a segment that mixes languages, so mixed-language calls are supported. Thelanguagelabel on a segment is the speech-to-text provider’s per-chunk detection and can differ from the words inside it. A line the translator did not answer is reported withtranslated_text: nullandTRANSLATION_FAILED, never as original text presented as a translation.- Translation quality is best effort. Detected translation failures are reported with
TRANSLATION_FAILED, and the original transcript is retained.
Idempotency
Send anIdempotency-Key header with a value unique to the submission. A retry with the same key, upload_id and target_language returns the existing job and does not start a second workflow. Reusing a key with a different upload_id or target_language starts a new job. Each call still counts against your organization’s transcription limit, retries included.
If the submission returns 503 (TRANSCRIPTION_SUBMIT_UNAVAILABLE), the job may or may not have started. Wait Retry-After seconds and submit again with the same Idempotency-Key; without a key, a retry can process the same recording twice.
Submitting an
upload_id whose file was never PUT, or that belongs to another organization, returns 404, as does a new submission for an upload whose audio was deleted (90 days after upload); an empty file or one larger than 2 GB returns 400. A new submission returns status queued; a retry with the same Idempotency-Key returns the job’s current status. Neither confirms successful processing.Authorizations
Headers
Unique per submission; a retry with the same key returns the existing job.
Body
application/json
Was this page helpful?