Create an AI Dubbing QC Run
curl --request POST \
--url https://api-integration.ollang.com/integration/orders/{orderId}/av-qc \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"requestId": "<string>"
}
'import requests
url = "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc"
payload = { "requestId": "<string>" }
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({requestId: '<string>'})
};
fetch('https://api-integration.ollang.com/integration/orders/{orderId}/av-qc', 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",
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([
'requestId' => '<string>'
]),
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-integration.ollang.com/integration/orders/{orderId}/av-qc"
payload := strings.NewReader("{\n \"requestId\": \"<string>\"\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-integration.ollang.com/integration/orders/{orderId}/av-qc")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"requestId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc")
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 \"requestId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyOllang API Reference
Create an AI Dubbing QC Run
Start a paid, asynchronous AI Dubbing QC report for an eligible AI Dubbing order
POST
/
integration
/
orders
/
{orderId}
/
av-qc
Create an AI Dubbing QC Run
curl --request POST \
--url https://api-integration.ollang.com/integration/orders/{orderId}/av-qc \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"requestId": "<string>"
}
'import requests
url = "https://api-integration.ollang.com/integration/orders/{orderId}/av-qc"
payload = { "requestId": "<string>" }
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({requestId: '<string>'})
};
fetch('https://api-integration.ollang.com/integration/orders/{orderId}/av-qc', 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",
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([
'requestId' => '<string>'
]),
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-integration.ollang.com/integration/orders/{orderId}/av-qc"
payload := strings.NewReader("{\n \"requestId\": \"<string>\"\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-integration.ollang.com/integration/orders/{orderId}/av-qc")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"requestId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-integration.ollang.com/integration/orders/{orderId}/av-qc")
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 \"requestId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyStarts a manual, report-only AI Dubbing QC run. The request is asynchronous: HTTP
The charge is the exact positive AI-credit amount from the unique qualifying AI-credit basket item on the order’s original paid checkout. Current pricing is not recomputed. Missing or ambiguous historical billing data fails closed; insufficient credits or the monthly limit blocks a new run. Infrastructure outcomes may be
AI Dubbing QC is available for completed AI Dubbing orders that were paid with AI credits. Audio Description orders are not eligible. A video can be up to 240 minutes long and up to 2 GiB per file; a longer or larger order is reported as not eligible. Orders with visual translation are checked on their final video, and their translated on-screen text is checked as a separate section of the report. Orders with LipSync on only some segments are checked without scoring lip-sync accuracy. LipSync on every segment is scored within the dubbing sync dimension. Creating a run requires the
An unknown or inaccessible order returns
202 acknowledges the run; poll its returned id for a terminal status. This endpoint does not change the order or edit its media.
Authorization
Send the integration API key inx-api-key. The order must belong to the client identified by the key.
Path parameters
Request body
The body accepts exactly one field,requestId, a UUID. Unknown fields are rejected. The order decides the scope; a request cannot choose the scope, the checked files or the cost.
UUID idempotency key. Generate a new UUID for a deliberate new run. Retry an uncertain request with the same UUID; do not create a new key because the response was lost or timed out. The same key returns the existing request/run rather than charging twice.
curl -X POST "https://api-integration.ollang.com/integration/orders/507f1f77bcf86cd799439011/av-qc" \
-H "x-api-key: $OLLANG_API_KEY" \
-H "Content-Type: application/json" \
-d '{"requestId":"550e8400-e29b-41d4-a716-446655440000"}'
partial, failed, or blocked and are refunded at most once; a completed quality failure remains charged.
Accepted response
HTTP202 returns the run resource, including id, status, chargeAmount (AI credits), immutable scope, artifactFingerprint, and checkedArtifacts. Use the returned id with the history, detail, and export endpoints. A server response may be unavailable after acceptance; retry the POST with the same requestId or look up the run through history. History does not expose requestId.
{
"id": "507f1f77bcf86cd799439012",
"orderId": "507f1f77bcf86cd799439011",
"status": "queued",
"createdAt": "2025-02-03T12:00:00.000Z",
"chargeAmount": 1800,
"scope": {
"modules": { "dubbing": true, "lip_sync": false, "visual_translation": false },
"sourceLanguage": "en",
"targetLanguage": "fr",
"lipSyncMode": "disabled",
"lipSyncRanges": []
},
"artifactFingerprint": "sha256-fingerprint",
"checkedArtifacts": [],
"outdated": false
}
Poll a run
Poll only while processing isqueued or running. Treat terminal partial as incomplete infrastructure coverage, not as completed; a quality verdict is stored in the report and is independent of processing status.
order_id="507f1f77bcf86cd799439011"
request_id="550e8400-e29b-41d4-a716-446655440000"
api="https://api-integration.ollang.com/integration/orders/$order_id/av-qc"
accepted=$(curl --fail-with-body -sS -X POST "$api" \
-H "x-api-key: $OLLANG_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"requestId\":\"$request_id\"}")
run_id=$(printf '%s' "$accepted" | jq -r '.id')
status=$(printf '%s' "$accepted" | jq -r '.status')
while [[ "$status" == "queued" || "$status" == "running" ]]; do
sleep 5
run=$(curl --fail-with-body -sS "$api/$run_id" -H "x-api-key: $OLLANG_API_KEY")
status=$(printf '%s' "$run" | jq -r '.status')
done
case "$status" in
completed) echo "Run completed; inspect report.verdict separately." ;;
partial) echo "Run is partial; do not treat it as a complete assessment." ;;
failed|blocked) echo "Run ended with status: $status" ;;
*) echo "Unexpected terminal status: $status"; exit 1 ;;
esac
client_owner or client_createOrder role on the API key’s user.
A run that cannot start returns 409 with the same reasons the pricing endpoint reports (for example insufficient_ai_credits or monthly_ai_credit_limit_exceeded), or one of:
message | What to do |
|---|---|
An AV QC run is already active for this order | Wait for the active run to finish; one run per order runs at a time. |
AV QC creation encountered a concurrent update; retry with the same requestId | Retry with the same requestId. It never charges twice. |
404.Was this page helpful?