Inferences

Get inference run

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

get/v2/workspaces/{workspace_id}/inferences/{inference_id}

Path parameters

workspace_idstring uuid required

Id of the workspace that owns the resource.

Id of the workspace that owns the resource.

inference_idstring uuid required

Id of the generation.

Id of the generation.

Response

Successful Response

inference_idstring uuid required

Unique identifier for this inference run.

status'in_progress' | 'complete' | 'failed' | 'cancelled' | 'deleted' required
poll_interval_secondsinteger nullable

Suggested polling interval in seconds. Present while IN_PROGRESS.

completed_atstring date-time nullable

Completion timestamp. Present only on COMPLETE.

actual_price_creative_unitsnumber nullable

Actual Creative Units charged. Present only on COMPLETE.

errorstring nullable

Error message. Present only on FAILED.

error_codestring 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_idstring nullable

Base model the run used, resolved or auto-picked.

reference_sets_degradedboolean

True when at least one attached reference set did not meaningfully contribute. The run still costs Creative Units.

reference_sets_warningstring nullable

Names each degraded reference set and why, or null when none is degraded.

Changes

No recorded changes to this endpoint across all 1 revision of this API.