> For clean Markdown of any page, append `.md` to the page URL. > For a complete documentation index, see https://docs.sarvam.ai/llms.txt. > For full documentation content in one file, see https://docs.sarvam.ai/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server. # Live Status GET https://api.sarvam.ai/dubbing/jobs/{job_id}/live-status Poll the pipeline progress of a dubbing job. `data.status` moves from `queued` to `in_progress`, then to `completed` or `failed`. > **Note:** `live-status` is a progress signal only. The source of truth for downloadable outputs is `GET /jobs/{job_id}/export-status`. Each `(target_language, export_type)` export completes independently and carries its own `status` and `download_url`. Reference: https://docs.sarvam.ai/api-reference/creative-agents-dubbing/live-status ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: '' version: 1.0.0 paths: /jobs/{job_id}/live-status: get: operationId: get-live-status summary: Get Dubbing Live Status description: >- Poll the pipeline progress of a dubbing job. `data.status` moves from `queued` to `in_progress`, then to `completed` or `failed`. > **Note:** `live-status` is a progress signal only. The source of truth for downloadable outputs is `GET /jobs/{job_id}/export-status`. Each `(target_language, export_type)` export completes independently and carries its own `status` and `download_url`. tags: - dubbing parameters: - name: job_id in: path description: The `job_id` returned by `POST /jobs`. required: true schema: type: string - name: api-subscription-key in: header required: true schema: type: string responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/Sarvam_Creative_API_DubbingLiveStatusResponse '401': description: Unauthorized. Send a valid `api-subscription-key`. content: application/json: schema: $ref: '#/components/schemas/Sarvam_Model_API_ErrorMessage' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Sarvam_Model_API_ErrorMessage' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Sarvam_Model_API_ErrorMessage' servers: - url: https://api.sarvam.ai/dubbing description: Creative components: schemas: Sarvam_Creative_API_DubbingJobStatus: type: string enum: - queued - in_progress - completed - failed - partial_failure - deleted title: Sarvam_Creative_API_DubbingJobStatus Sarvam_Creative_API_DubbingLiveStatusExportInfo: type: object properties: target_language: type: string description: Target language (BCP-47). status: type: string description: Export status, e.g. `completed`, `in_progress`, `failed`. dubbed_video_url: type: - string - 'null' description: Signed URL for the dubbed video. original_video_url: type: - string - 'null' description: Signed URL for the original video. duration: type: - number - 'null' format: double description: Video duration in seconds. file_size: type: - integer - 'null' description: File size in bytes. title: Sarvam_Creative_API_DubbingLiveStatusExportInfo Sarvam_Creative_API_DubbingLiveStatusData: type: object properties: job_id: type: string job_name: type: - string - 'null' status: $ref: '#/components/schemas/Sarvam_Creative_API_DubbingJobStatus' current_step: type: - string - 'null' description: Current pipeline step key. current_step_label: type: - string - 'null' description: Human-readable label of the current pipeline step. progress: type: integer default: 0 description: Overall progress percentage (0–100). export: oneOf: - $ref: >- #/components/schemas/Sarvam_Creative_API_DubbingLiveStatusExportInfo - type: 'null' description: Export status when the job has a single target language. exports: type: - array - 'null' items: $ref: >- #/components/schemas/Sarvam_Creative_API_DubbingLiveStatusExportInfo description: >- Export status per language when the job has multiple target languages. error_message: type: - string - 'null' description: Populated when `status` is `failed`. title: Sarvam_Creative_API_DubbingLiveStatusData Sarvam_Creative_API_DubbingLiveStatusResponse: type: object properties: status: type: string description: Response status, e.g. `success`. message: type: string data: $ref: '#/components/schemas/Sarvam_Creative_API_DubbingLiveStatusData' title: Sarvam_Creative_API_DubbingLiveStatusResponse Sarvam_Model_API_ErrorCode: type: string enum: - invalid_request_error - internal_server_error - unprocessable_entity_error - insufficient_quota_error - invalid_api_key_error - authentication_error - not_found_error - rate_limit_exceeded_error title: Sarvam_Model_API_ErrorCode Sarvam_Model_API_ErrorDetails: type: object properties: request_id: type: - string - 'null' message: type: string description: Message describing the error code: $ref: '#/components/schemas/Sarvam_Model_API_ErrorCode' description: >- Error code for the specific error that has occurred. Refer to the error code documentation for more details. required: - request_id - message - code title: Sarvam_Model_API_ErrorDetails Sarvam_Model_API_ErrorMessage: type: object properties: error: $ref: '#/components/schemas/Sarvam_Model_API_ErrorDetails' description: Error details required: - error title: Sarvam_Model_API_ErrorMessage securitySchemes: ApiKeyAuth: type: apiKey in: header name: api-subscription-key ``` ## Examples **Response** ```json { "status": "success", "message": "Live status retrieved successfully", "data": { "job_id": "dub_5cb7faa6", "job_name": "segment1", "status": "in_progress", "current_step": "tts", "current_step_label": "Generating dubbed audio", "progress": 60, "error_message": null } } ``` **SDK Code** ```typescript import { SarvamAIClient } from "sarvamai"; async function main() { const client = new SarvamAIClient({ apiSubscriptionKey: "YOUR_API_KEY_HERE", }); await client.dubbing.getLiveStatus("dub_5cb7faa6"); } main(); ``` ```python from sarvamai import SarvamAI client = SarvamAI( api_subscription_key="YOUR_API_KEY_HERE", ) client.dubbing.get_live_status( job_id="dub_5cb7faa6", ) ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("api-subscription-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["api-subscription-key"] = '' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status") .header("api-subscription-key", "") .asString(); ``` ```php request('GET', 'https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status', [ 'headers' => [ 'api-subscription-key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status"); var request = new RestRequest(Method.GET); request.AddHeader("api-subscription-key", ""); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["api-subscription-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.sarvam.ai/dubbing/jobs/dub_5cb7faa6/live-status")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```