Skip to main content
POST
Create an AI Dubbing QC Run
Starts a manual, report-only AI Dubbing QC run. The request is asynchronous: HTTP 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 in x-api-key. The order must belong to the client identified by the key.

Path parameters

string
required
ID of the AI Dubbing order.

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.
string
required
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.
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 partial, failed, or blocked and are refunded at most once; a completed quality failure remains charged.

Accepted response

HTTP 202 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.

Poll a run

Poll only while processing is queued 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.
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 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: An unknown or inaccessible order returns 404.