Get Execution by ID

!pip install vlmrun from vlmrun.client import VLMRun from vlmrun.client.types import AgentExecutionResponse client = VLMRun(api_key="<VLMRUN_API_KEY>") response: AgentExecutionResponse = client.executions.get("<execution_id>")

import { VlmRun } from "vlmrun"; const client = new VlmRun({ baseURL: "https://api.vlm.run/v1", apiKey: "<VLMRUN_API_KEY>" }); const response = await client.executions.get("<execution_id>"); console.log(response);

{ "name": "<string>", "usage": { "elements_processed": 123, "credits_used": 123, "steps": 123, "message": "<string>", "duration_seconds": 0, "service_tier": "<string>", "mode_multiplier": 123, "standard_cost_dollars": 123, "cost_dollars": 123, "savings_dollars": 123 }, "id": "<string>", "response": "<unknown>", "execution_mode": "agent", "status": "pending", "created_at": "2023-11-07T05:31:56Z", "completed_at": "2023-11-07T05:31:56Z" }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Response

Successful Response

Response to the agent execution request.

name

string

required

Name of the agent

usage

CreditUsageResponse · object

The usage metrics for the request.

Hide child attributes

usage.elements_processed

integer | null

Number of elements processed.

usage.element_type

enum<string> | null

The type of element processed (e.g. image, page, video, audio).

Available options:

image,

page,

video,

audio

usage.credits_used

integer | null

Amount of total credits used.

usage.steps

integer | null

Number of steps processed, in case of agentic execution.

usage.message

string | null

The message from the credit usage job.

usage.duration_seconds

integer

default:0

Duration of the request in seconds.

usage.service_tier

string | null

Delivery tier (standard, priority, flex).

usage.mode_multiplier

number | null

Pricing multiplier applied to standard cost.

usage.standard_cost_dollars

number | null

Pre-multiplier customer cost in USD, derived from tokens and unit rates.

usage.cost_dollars

number | null

Effective customer cost in USD after the service-tier multiplier.

usage.savings_dollars

number | null

Discount in USD when using flex (standard_cost_dollars - cost_dollars).

string

Unique identifier of the agent execution response.

response

any | null

The response from the model.

execution_mode

enum<string>

default:agent

How the execution ran: program when a cached skill pipeline.py ran as fixed code (no LLM agent loop), else agent. Always agent for non-Orion-2 models.

Available options:

agent,

program

status

enum<string>

default:pending

The status of the job.

Available options:

pending,

enqueued,

running,

completed,

failed,

paused

created_at

string<date-time>

Date and time when the execution was created (in UTC timezone)

completed_at

string<date-time> | null

Date and time when the execution was completed (in UTC timezone)

Get Started

Health

Generate

Predictions

Chat

Agent

Executions

Files

Models / Hub

Skills

Artifacts

Feedback

Get Execution by ID

Authorizations

Path Parameters

Response