Retrieve LTX Studio job status

June 3, 2025

Table of contents

  1. Request Headers
  2. Path Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

This endpoint retrieves the status and result of a specific generation job by its jobId for following endpoints:

https://api.useapi.net/v1/ltxstudio/assets/jobId

Request Headers
Authorization: Bearer {API token}
Path Parameters
  • jobId is required, specify the job to retrieve
Responses
  • 200 OK

    {
        "status": {
            "type": "completed",
            "progress": 100,
            "artifact": {
                "assetUrl": "https://storage.googleapis.com/lt-infinity-prd/artifacts/model-serving/…",
                "expirationDateString": "1748919477350",
                "asset": {
                    "type": "artifact",
                    "fileId": "asset:3b18…-type:video/mp4",
                    "mimeType": "video/mp4",
                    "artifactSubtype": "model-serving"
                }
            }
        },
        "jobId": "email:[email protected]:7a34b821-9fd0-205e-d21b-4abc6f7839e7-type:video",
        "replyRef": "custom-reference-123",
        "replyUrl": "https://webhook.example.com/ltx-callback"
    }
    
  • 400 Bad Request

    {
      "error": "Error message",
      "code": 400
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
  • 404 Not Found

    Job not found or has expired.

Model

Make sure to check both field status.type value to be completed and field artifact.assetUrl to be present since they may be out of sync.

{ // TypeScript, all fields are optional
    status: {
        type: 'active' | 'completed' | 'failed'
        progress?: number
        message?: string
        artifact?: {
            assetUrl: string
            expirationDateString: string
            asset: {
                type: string
                fileId: string
                mimeType: string
                artifactSubtype: string
            }
        }
    }
    jobId?: string
    replyRef?: string
    replyUrl?: string
    code?: number
}
Examples
  • curl https://api.useapi.net/v1/ltxstudio/assets/email:[email protected]:7a34…-type:video \
       -H "Authorization: Bearer …" 
    
  • const token = "API token";
    const jobId = "email:[email protected]:7a34…-type:video";
    const apiUrl = `https://api.useapi.net/v1/ltxstudio/assets/${jobId}`; 
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    job_id = "email:[email protected]:7a34…-type:video"
    apiUrl = f"https://api.useapi.net/v1/ltxstudio/assets/{job_id}"
    headers = {
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers)
    print(response, response.json())
    
Try It