---
title: "Get inference run"
method: GET
path: "/v2/workspaces/{workspace_id}/inferences/{inference_id}"
tags: ["Inferences"]
---

# Get inference run

`GET /v2/workspaces/{workspace_id}/inferences/{inference_id}`

Get the status and results of an inference run, plus what each attached reference set contributed to it.

## Path parameters

- `workspace_id` string, uuid, required — Id of the workspace that owns the resource.
- `inference_id` string, uuid, required — Id of the generation.

## Response `200`

Successful Response

- GetInferenceRunV2Output
  - `inference_id` string, uuid, required — Unique identifier for this inference run.
  - `status` 'in_progress' | 'complete' | 'failed' | 'cancelled' | 'deleted', required
  - `poll_interval_seconds` integer, nullable — Suggested polling interval in seconds. Present while IN_PROGRESS.
  - `completed_at` string, date-time, nullable — Completion timestamp. Present only on COMPLETE.
  - `outputs` ForgeRunAsset[], nullable — Generated assets. Present only on COMPLETE.
    - `file_id` string, uuid, required — File ID for the generated asset.
    - `url` string, required — Download URL for the asset.
    - `content_type` string, required — MIME type, e.g. image/png or video/mp4.
    - `preview_url` string, nullable — Thumbnail/preview URL.
    - `width` integer, nullable — Width in pixels.
    - `height` integer, nullable — Height in pixels.
    - `duration_seconds` number, nullable — Duration for video/audio assets.
    - `file_size_bytes` integer, nullable — File size in bytes.
  - `actual_price_creative_units` number, nullable — Actual Creative Units charged. Present only on COMPLETE.
  - `error` string, nullable — Error message. Present only on FAILED.
  - `error_code` string, nullable — Machine-readable error code. Present only on FAILED. Balance-related values: `INSUFFICIENT_BALANCE` (the workspace ran out of Creative Units — top up and resubmit) and `BALANCE_UNAVAILABLE` (the balance could not be verified — retry later).
  - `base_model_id` string, nullable — Base model the run used, resolved or auto-picked.
  - `reference_set_contributions` ForgeReferenceSetContribution[] — Per-set summary of what each reference set contributed.
    - `set_id` string, uuid, nullable — Reference Set ID this contribution belongs to, if any.
    - `lora_applied` boolean — True when a LoRA finetune was applied for this set.
    - `animation_applied` boolean — True when an animation (Meshy rigging action) finetune was applied for this set.
    - `voice_applied` boolean — True when a voice (ElevenLabs) finetune was applied for this set.
    - `mapped_asset_count` integer — Number of assets successfully mapped to guidance inputs.
    - `prompt_fallback_applied` boolean — True when the set fell back to prompt-only representation.
    - `lora_available_but_incompatible` boolean — True when SBMC has a LoRA for this set on another base model but not the one used.
    - `skipped_not_applicable` boolean — 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.
  - `reference_sets_degraded` boolean — True when at least one attached reference set did not meaningfully contribute. The run still costs Creative Units.
  - `reference_sets_warning` string, nullable — Names each degraded reference set and why, or null when none is degraded.

## Other responses

- `401` — Unauthenticated — missing or invalid Bearer token.
- `403` — Forbidden — insufficient permissions, or the access token lacks the scope the operation requires.
- `404` — Resource not found.
- `409` — The request with this `Idempotency-Key` is still running — retry after the number of seconds in `Retry-After`.
- `422` — Invalid input parameters, or an `Idempotency-Key` reused for a different request.
- `429` — Rate limited — retry after the number of seconds in `Retry-After`.
- `500` — Internal server error.

---

[API](https://skmtc.dev/layer/apis/layer-rest-api.md) · [All operations](https://skmtc.dev/layer/apis/layer-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/layer/layer-rest-api/revisions/fafc779f9ba2/schema)