# Get inference run GET /v2/workspaces/{workspace\_id}/inferences/{inference\_id} ```bash curl --request GET \ --url https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id \ --header 'Authorization: Bearer ' ``` ```python import requests url = "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```js const url = 'https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```php "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "Authorization: Bearer " ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ```java OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id") .get() .addHeader("Authorization", "Bearer ") .build(); Response response = client.newCall(request).execute(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```csharp var client = new RestClient("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences/:inference_id"); var request = new RestRequest("", Method.Get); request.AddHeader("Authorization", "Bearer "); var response = client.Execute(request); ``` * Production > **Changed in v2.** This endpoint’s contract differs from v1\. See the [v2 migration guide](/docs/migration) for the request and response changes before you switch. Get the status and results of an inference run, plus what each attached reference set contributed to it. ## Authorizations * **[bearerAuth](/docs/v2/rest-api#bearerauth)** ## Parameters ### Path Parameters **workspace\_id** required _Workspace Id_ Id of the workspace that owns the resource. string format: uuid Id of the workspace that owns the resource. **inference\_id** required _Inference Id_ Id of the generation. string format: uuid Id of the generation. ## Responses ### 200 Successful Response _GetInferenceRunV2Output_object **inference\_id** required _Inference Id_ Unique identifier for this inference run. string format: uuid **status** required _InferenceStatus_ Current status: in\_progress, complete, failed, cancelled, or deleted. string Allowed values: in\_progress complete failed cancelled deleted **poll\_interval\_seconds** Any of: **integer** integer **null** null **completed\_at** Any of: **string** string format: date-time **null** null **outputs** Any of: **Array** Array _ForgeRunAsset_object **file\_id** required _File Id_ File ID for the generated asset. string format: uuid **url** required _Url_ Download URL for the asset. string **content\_type** required _Content Type_ MIME type, e.g. image/png or video/mp4. string **preview\_url** Any of: **null** string **string** null **width** Any of: **null** integer **integer** null **height** Any of: **null** integer **integer** null **duration\_seconds** Any of: **null** number **number** null **file\_size\_bytes** Any of: **null** integer **integer** null **null** null **actual\_price\_creative\_units** Any of: **number** number **null** null **error** Any of: **string** string **null** null **error\_code** Any of: **string** string **null** null **base\_model\_id** Any of: **string** string **null** null **reference\_set\_contributions** _Reference Set Contributions_ Per-set summary of what each reference set contributed. Array default: _ForgeReferenceSetContribution_object **set\_id** Any of: **string** string format: uuid **null** null **lora\_applied** _Lora Applied_ True when a LoRA finetune was applied for this set. boolean **animation\_applied** _Animation Applied_ True when an animation (Meshy rigging action) finetune was applied for this set. boolean **voice\_applied** _Voice Applied_ True when a voice (ElevenLabs) finetune was applied for this set. boolean **mapped\_asset\_count** _Mapped Asset Count_ Number of assets successfully mapped to guidance inputs. integer 0 **prompt\_fallback\_applied** _Prompt Fallback Applied_ True when the set fell back to prompt-only representation. boolean **lora\_available\_but\_incompatible** _Lora Available But Incompatible_ True when SBMC has a LoRA for this set on another base model but not the one used. boolean **skipped\_not\_applicable** _Skipped Not Applicable_ True when the set isn’t applicable to the chosen model (its modality / applicable base models exclude it) so no LoRA or assets were applied. boolean **reference\_sets\_degraded** _Reference Sets Degraded_ True when at least one attached reference set did not meaningfully contribute. The run still costs Creative Units. boolean **reference\_sets\_warning** Any of: **string** string **null** null ##### Example ```json { "status": "in_progress", "reference_set_contributions": [], "reference_sets_degraded": false } ``` ### 401 Unauthenticated — missing or invalid Bearer token. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 403 Forbidden — insufficient permissions. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 404 Resource not found. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 422 Invalid input parameters. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 429 Rate limited — too many concurrent requests. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 500 Internal server error. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ```