Get an AI Dubbing QC Run
curl --request GET \
--url https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}', 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-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_bodyOllang API Reference
Get an AI Dubbing QC Run
Retrieve stored status, report, scope, and artifact identity for an AI Dubbing QC run
GET
/
integration
/
orders
/
{orderId}
/
av-qc
/
{runId}
Get an AI Dubbing QC Run
curl --request GET \
--url https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}', 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-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc/{runId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_bodyReturns a run and its stored results. Reading a run does not start another evaluation or charge credits.
Each entry has
A report made before language checks were introduced has no
A run made before on-screen text was checked has
Authorization
Send the integration API key inx-api-key. The order and run must belong to the client identified by the key.
Path parameters
curl "https://api-integration.ollang.com/integration/orders/507f1f77bcf86cd799439011/av-qc/507f1f77bcf86cd799439012" \
-H "x-api-key: $OLLANG_API_KEY"
Run status and quality verdict
Runstatus is one of queued, running, completed, partial, failed, or blocked. Poll while queued/running; stop at a terminal status. Infrastructure outcomes may be partial, failed, or blocked and are refunded at most once; partial indicates incomplete coverage. A quality verdict is separate: report.verdict is pass, pass_with_fixes, or fail. Completed quality failures remain charged.
AI Dubbing QC covers completed AI Dubbing orders that were paid with AI credits. For an order with visual translation, the translated on-screen text is checked too, as a separate section of the report. Lip-sync accuracy is scored only when LipSync covers every segment. The API key’s user needs the client_owner, client_view or client_createOrder role; other roles receive 403.
The report uses schema 1.0 field names; it is not wrapped in another object. Its top-level fields are schema_version, job_id, category, generated_at, languages, duration_seconds, options, score, verdict, dimensions, checks, findings, rejected_findings, corrective_actions, passes, and limitations. The dubbing score has five dimensions: translation accuracy, synchronization, voice, audio mix and completeness. LipSync on every segment contributes to the sync dimension; there is no separate LipSync score. When LipSync covers only some segments, the order is checked as a standard dub and lip-sync accuracy is not scored. Each entry in passes has a name, a status and its duration in seconds.
The following is an illustrative excerpt only, not a complete qc_report.json:
{
"findings": [
{
"id": "F-MAJOR-CONFIRMED",
"dimension": "mix",
"severity": "major",
"start": 24,
"end": 25.2,
"title": "Music masks dialogue",
"description": "The delivered mix masks a word at the cue boundary.",
"origin": "model",
"evidence": {
"source_quote": "Come inside",
"delivered_quote": "Entrez",
"metric": { "observed_seconds": 1.2, "expected_seconds": 1.0 }
},
"confirmation": {
"state": "confirmed",
"reason": "Reconfirmed against the delivered mix."
}
}
],
"corrective_actions": [
{
"id": "A003",
"finding_id": "F-MAJOR-CONFIRMED",
"priority": "P2",
"action_type": "re_dub_segment",
"start": 24,
"end": 25.2,
"dimension": "mix",
"instruction": "Lower music under the final spoken word.",
"current": "Entrez",
"proposed": "Entrez maintenant.",
"owner": "audio_engineer"
}
]
}
Language checks
Translation accuracy is examined one language check at a time.report.checks has one entry per check, and every translation accuracy finding names its check in check. The checks score inside the translation accuracy dimension; they do not add dimensions or change the score formula.
id | Check |
|---|---|
meaning | Meaning |
omission_addition | Omission and addition |
negation_polarity | Negation and conditions |
certainty_claims | Certainty and claims |
health_legal | Health, safety and legal wording |
numbers_units | Numbers, units and dates |
terminology | Terminology and names |
offensive_language | Offensive language |
grammar | Grammar |
gendered_reference | Grammatical gender |
register | Register and formality |
tone | Tone of voice |
inclusive_language | Inclusive language |
plain_language | Plain language |
locale_conventions | Locale conventions |
consistency | Consistency |
id, label, dimension (accuracy), result, findings (the number of standing findings) and an optional note. result is one of:
result | Meaning |
|---|---|
passed | The check was examined and no finding stands. |
issues | At least one finding stands under this check. |
not_applicable | The content has nothing for this check to examine; note says why. |
not_checked | The check was not examined in this run. Do not treat it as passed. |
note also says what a result rests on, for example that terminology was checked without a glossary, or that an issue was reported but not upheld when it was re-checked. A finding that was not upheld is listed in rejected_findings, not in findings. A completeness finding for a missing line can also carry check: "omission_addition".
{
"checks": [
{ "id": "meaning", "label": "Meaning", "dimension": "accuracy", "result": "passed", "findings": 0, "note": "" },
{ "id": "negation_polarity", "label": "Negation and conditions", "dimension": "accuracy", "result": "issues", "findings": 1, "note": "" },
{ "id": "locale_conventions", "label": "Locale conventions", "dimension": "accuracy", "result": "not_applicable", "findings": 0, "note": "No dates, numbers or currency are spoken." }
]
}
checks and no check on its findings.
On-screen text
For an order with visual translation, the run also checks the translated text in the picture: titles, burned-in captions, lower thirds, labels, interface text, end cards and disclaimers. Brand and product names, logos and web addresses are expected to stay as they are. Such a run hasscope.modules.visual_translation: true, and its report carries extension_version: "av-qc-ost/v1" and a visual_translation section. That section is a complete report of its own, with the same fields as the dubbing report (score, verdict, dimensions, findings, rejected_findings, corrective_actions, passes, limitations) and category: "visual_translation". It does not change the dubbing score, verdict or findings.
Dimension id | What it covers | Weight |
|---|---|---|
translation_accuracy | The delivered text says what the source text says: meaning, numbers, negations, names, terminology | 35 |
completeness | Every text that should be translated is translated; nothing left in the source language, dropped or added | 25 |
readability | Not cut off or overflowing, legible, correct characters for the target script | 15 |
placement | The text sits where the source text sat | 10 |
timing | The text appears and disappears with the source text | 10 |
visual_artifacts | The picture around the text is clean | 5 |
coverage_complete says whether all on-screen text could be read and compared; when it is false, coverage_limitations lists what was not. A run whose on-screen text was only partly readable is still completed and charged. If the on-screen-text check could not run at all, the run is partial: the dubbing report is returned and the charge is refunded.
{
"extension_version": "av-qc-ost/v1",
"visual_translation": {
"category": "visual_translation",
"score": 77,
"verdict": "fail",
"coverage_complete": true,
"coverage_limitations": [],
"dimensions": [
{ "id": "translation_accuracy", "label": "Translation accuracy", "weight": 35, "score": 65 }
],
"findings": [
{
"id": "F002",
"dimension": "translation_accuracy",
"severity": "critical",
"start": 18,
"end": 24,
"title": "Negation missing from a warning",
"evidence": {
"source_quote": "Warning: not during pregnancy",
"delivered_quote": "Warnung: in der Schwangerschaft"
},
"confirmation": { "state": "confirmed" }
}
]
}
}
scope.modules.visual_translation: false and no visual_translation section.
scope is the scope stored with this run: what was produced and scored. Do not substitute the current pricing response’s scope when displaying a historical report. artifactFingerprint and checkedArtifacts identify the exact files that were checked. Each checkedArtifacts item has id, type, name, createdAt, updatedAt, and urlHash; no media URLs are returned. If outdated is true, the order’s files have changed since this report was made.
Use the export endpoint to download an XLSX built from this stored report. Exporting does not run QC or charge again.Was this page helpful?