from PIL import Imagefrom pydantic import BaseModel, Fieldfrom vlmrun.client import VLMRunfrom vlmrun.types import ImageRefclient = VLMRun(api_key="<VLMRUN_API_KEY>")# Define a response model with an ImageRef fieldclass BlurredImageResponse(BaseModel): image: ImageRef = Field(..., description="The blurred image")# Make a chat completion request that generates an image artifactresponse = client.agent.completions.create( model="vlmrun-orion-2:auto", messages=[ { "role": "user", "content": [ {"type": "text", "text": "Blur all the faces in this image"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] } ], response_format={"type": "json_schema", "schema": BlurredImageResponse.model_json_schema()},)# Parse the response to get the artifact referenceresult = BlurredImageResponse.model_validate_json(response.choices[0].message.content)# Retrieve the artifact using session_id and object_idimage: Image.Image = client.artifacts.get( session_id=response.session_id, object_id=result.image.id,)
import { VlmRun } from "vlmrun";const client = new VlmRun({ baseURL: "https://api.vlm.run/v1", apiKey: "<VLMRUN_API_KEY>"});// Retrieve the artifact using session_id and object_idconst artifact = await client.artifacts.get({ sessionId: "<SESSION_ID>", objectId: "img_a1b2c3"});console.log(artifact);
Retrieve an artifact by session ID or execution ID.
GET
/
v1
/
artifacts
from PIL import Imagefrom pydantic import BaseModel, Fieldfrom vlmrun.client import VLMRunfrom vlmrun.types import ImageRefclient = VLMRun(api_key="<VLMRUN_API_KEY>")# Define a response model with an ImageRef fieldclass BlurredImageResponse(BaseModel): image: ImageRef = Field(..., description="The blurred image")# Make a chat completion request that generates an image artifactresponse = client.agent.completions.create( model="vlmrun-orion-2:auto", messages=[ { "role": "user", "content": [ {"type": "text", "text": "Blur all the faces in this image"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] } ], response_format={"type": "json_schema", "schema": BlurredImageResponse.model_json_schema()},)# Parse the response to get the artifact referenceresult = BlurredImageResponse.model_validate_json(response.choices[0].message.content)# Retrieve the artifact using session_id and object_idimage: Image.Image = client.artifacts.get( session_id=response.session_id, object_id=result.image.id,)
import { VlmRun } from "vlmrun";const client = new VlmRun({ baseURL: "https://api.vlm.run/v1", apiKey: "<VLMRUN_API_KEY>"});// Retrieve the artifact using session_id and object_idconst artifact = await client.artifacts.get({ sessionId: "<SESSION_ID>", objectId: "img_a1b2c3"});console.log(artifact);
Retrieve the raw content of an artifact using either a session_id (for chat completions) or an execution_id (for agent executions), along with the object_id from the response. Artifacts are binary objects generated during agent interactions, such as images, videos, audio files, and documents.
For a comprehensive guide on working with artifacts, including usage patterns and examples, see the Artifacts Guide.
Query Parameters
Parameter
Type
Required
Description
object_id
string
Yes
Object ID for the artifact (format: <type>_<6-hex-chars>, e.g., img_a1b2c3)
session_id
string
No
Session ID from chat completions (mutually exclusive with execution_id)
execution_id
string
No
Execution ID from agent executions (mutually exclusive with session_id)
Either session_id or execution_id must be provided, but not both. Use session_id for artifacts from chat completions and execution_id for artifacts from agent executions.
Object Reference Format
Object references follow the format: <type_prefix>_<6-digit-hex-string> (e.g., img_a1b2c3).
Artifact Type
Prefix
Reference Type
Python Return Type
Image
img_
ImageRef
PIL.Image.Image
Video
vid_
VideoRef
Path (mp4)
Audio
aud_
AudioRef
Path (mp3)
Document
doc_
DocumentRef
Path (pdf)
Reconstruction
recon_
ReconRef
Path (spz)
URL
url_
UrlRef
Path (any of the above)
Array
arr_
ArrayRef
np.ndarray
The Python SDK provides convenience methods that automatically convert artifacts to the appropriate Python types.
Response
Returns the raw binary content of the artifact with the appropriate content type based on the artifact type.
Get Artifact by Session ID
Use session_id to retrieve artifacts from chat completion responses.
from PIL import Imagefrom pydantic import BaseModel, Fieldfrom vlmrun.client import VLMRunfrom vlmrun.types import ImageRefclient = VLMRun(api_key="<VLMRUN_API_KEY>")# Define a response model with an ImageRef fieldclass BlurredImageResponse(BaseModel): image: ImageRef = Field(..., description="The blurred image")# Make a chat completion request that generates an image artifactresponse = client.agent.completions.create( model="vlmrun-orion-2:auto", messages=[ { "role": "user", "content": [ {"type": "text", "text": "Blur all the faces in this image"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] } ], response_format={"type": "json_schema", "schema": BlurredImageResponse.model_json_schema()},)# Parse the response to get the artifact referenceresult = BlurredImageResponse.model_validate_json(response.choices[0].message.content)# Retrieve the artifact using session_id and object_idimage: Image.Image = client.artifacts.get( session_id=response.session_id, object_id=result.image.id,)
import { VlmRun } from "vlmrun";const client = new VlmRun({ baseURL: "https://api.vlm.run/v1", apiKey: "<VLMRUN_API_KEY>"});// Retrieve the artifact using session_id and object_idconst artifact = await client.artifacts.get({ sessionId: "<SESSION_ID>", objectId: "img_a1b2c3"});console.log(artifact);
Get Artifact by Execution ID
Use execution_id to retrieve artifacts from agent execution responses.
from PIL import Imagefrom pydantic import BaseModel, Fieldfrom vlmrun.client import VLMRunfrom vlmrun.client.types import AgentExecutionConfig, AgentExecutionResponse, ImageUrlfrom vlmrun.types import ImageRef, MessageContentclient = VLMRun(api_key="<VLMRUN_API_KEY>")# Define typed inputs and response modelclass ExecutionInputs(BaseModel): image: MessageContent = Field(..., description="The input image")class ImageResponse(BaseModel): image: ImageRef = Field(..., description="The processed image")# Execute an agentexecution: AgentExecutionResponse = client.agent.execute( name="image/blur-image", inputs=ExecutionInputs( image=MessageContent(type="image_url", image_url=ImageUrl(url="https://example.com/photo.jpg")) ), config=AgentExecutionConfig( prompt="Blur the entire image", response_model=ImageResponse ))# Wait for completionexecution = client.executions.wait(execution.id, timeout=180)# Parse the response and retrieve the artifact using execution_idresult = ImageResponse.model_validate(execution.response)image: Image.Image = client.artifacts.get( execution_id=execution.id, object_id=result.image.id,)
import { VlmRun } from "vlmrun";const client = new VlmRun({ baseURL: "https://api.vlm.run/v1", apiKey: "<VLMRUN_API_KEY>"});// Retrieve the artifact using execution_id and object_idconst artifact = await client.artifacts.get({ executionId: "<EXECUTION_ID>", objectId: "img_a1b2c3"});console.log(artifact);
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
session_id
string | null
Session ID for the artifacts
execution_id
string | null
Execution ID for the artifacts
object_id
string | null
Object ID to retrieve a single artifact
filename
string | null
Workspace filename to retrieve a single artifact
limit
integer
default:100
Maximum number of items to return when listing
Required range: 1 <= x <= 1000
offset
integer
default:0
Number of items to skip when listing
Required range: x >= 0
Response
Successful Response
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"VLM Run","description":"One API key for every visual model. Send a document or an image, get JSON back.","colors":{"primary":"#1F5ACA","light":"#4D8BFF","dark":"#102A56"},"logo":{"light":"https://mintcdn.com/autonomiai/0Yrk6nqaa_NlkPay/assets/logo/vlm-run-icon.svg?fit=max\u0026auto=format\u0026n=0Yrk6nqaa_NlkPay\u0026q=85\u0026s=fbea8392452b746e14273d7670a4f535","dark":"https://mintcdn.com/autonomiai/0Yrk6nqaa_NlkPay/assets/logo/vlm-run-icon-white.svg?fit=max\u0026auto=format\u0026n=0Yrk6nqaa_NlkPay\u0026q=85\u0026s=e58c8973ce1978adf1ce6359665a916a"},"favicon":"https://mintcdn.com/autonomiai/0Yrk6nqaa_NlkPay/assets/logo/vlm-run-icon.svg?fit=max\u0026auto=format\u0026n=0Yrk6nqaa_NlkPay\u0026q=85\u0026s=fbea8392452b746e14273d7670a4f535","api":{"openapi":["https://api.vlm.run/openapi.json","https://gateway.vlm.run/openapi.json"],"params":{"expanded":"all"},"playground":{"display":"simple"},"examples":{"languages":["python","javascript","ruby","curl"]}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FAFCFE","dark":"#010917"}},"navbar":{"links":[{"href":"mailto:support@vlm.run","label":"Contact"},{"href":"https://github.com/vlm-run/vlmrun-hub","label":"Hub"},{"href":"https://github.com/vlm-run/vlmrun-cookbook","label":"Cookbooks"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.vlm.run"}},"footer":{"socials":{"x":"https://x.com/vlmrun","github":"https://github.com/vlm-run/vlm-cookbook","linkedin":"https://www.linkedin.com/company/vlm-run"}},"seo":{"metatags":{"og:type":"website","og:site_name":"VLM Run","twitter:card":"summary_large_image","twitter:site":"@vlmrun"}},"fonts":{"heading":{"family":"Aeonik Pro","weight":400,"source":"fonts/AeonikPro-Regular.woff2","format":"woff2"},"body":{"family":"Aeonik Pro","weight":400,"source":"fonts/AeonikPro-Regular.woff2","format":"woff2"}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"dark-plus"}},"latex":true},"integrations":{"ga4":{"measurementId":"G-DKFNLZ8F83"}},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/autonomiai/0lq3Q9EPRCLt1zej/images/og-background.png?fit=max\u0026auto=format\u0026n=0lq3Q9EPRCLt1zej\u0026q=85\u0026s=010b9a1e01253f5f9d02474d89f85294"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"autonomiai","hasAudioNarration":false,"actualSubdomain":"autonomiai","customDomains":["docs.vlm.run"],"gitSource":{"type":"github","owner":"vlm-run","repo":"docs","deployBranch":"release","contentDirectory":"public","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af8a42574b4f0f02ee12098","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Orion","count":42},{"language":"default","tag":"Developers","count":35},{"language":"default","tag":"Gateway","count":31},{"language":"default","tag":"API reference","count":26},{"language":"default","tag":"SDKs","count":24},{"language":"default","tag":"Orion API","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Skills","count":14},{"language":"default","tag":"Python","count":12},{"language":"default","tag":"Node.js","count":12}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url('https://fonts.googleapis.com/css2?family=Geist+Mono:wght@400;500;600\u0026display=swap');:root{--vlm-primary: #1F5ACA;--vlm-primary-hover: #1848A2;--vlm-primary-vivid: #1265FF;--vlm-primary-mid: #1F5ACA;--vlm-primary-dark: #1848A2;--vlm-primary-light: #4D8BFF;--vlm-primary-border: #234D9F;--vlm-primary-tint: #E0EAFA;--vlm-primary-badge: #EEF2F9;--vlm-navy: #102A56;--vlm-navy-dark: #010917;--vlm-navy-mid: #102255;--vlm-muted: #576782;--vlm-surface: #FAFCFE;--vlm-border: #E1ECFA;--vlm-dark-border: #182231;--vlm-toc-active: #274275;--vlm-cap-blue: rgb(100, 151, 246);--vlm-cap-green: rgb(185, 246, 100);--vlm-cap-purple: rgb(177, 118, 255);--vlm-shadow-btn:\n rgba(0, 0, 0, 0.20) 0px -2px 0px 0px inset,\n rgba(0, 0, 0, 0.20) 0px 1px 2px 0px}:root{--vlm-docs-version: \"Docs updated 2026-08-15\"}body{color:var(--vlm-navy);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}h1,h2,h3,h4,h5,h6{color:var(--vlm-navy);letter-spacing:0}#content>h2{margin-top:3rem;margin-bottom:1.5rem}#content>h3{margin-top:2.25rem;margin-bottom:1rem}#content>h4{margin-top:1.75rem;margin-bottom:0.75rem}#content>:is(h2,h3,h4):first-child{margin-top:0}#content>:is(h2,h3,h4)+table{margin-top:0}#content [data-table-wrapper=\"true\"]{margin-top:0;padding-top:0}#content [data-table-wrapper=\"true\"] table{margin-top:0}#content input.fold-rows{position:absolute;width:1px;height:1px;margin:0;opacity:0;pointer-events:none}#content input.fold-rows:not(:checked)+[data-table-wrapper=\"true\"] tbody tr:nth-child(n+7){display:none}#content input.fold-rows:not(:checked)+[data-table-wrapper=\"true\"]{position:relative}#content input.fold-rows:not(:checked)+[data-table-wrapper=\"true\"]::after{content:\"\";position:absolute;left:0;right:0;bottom:0;height:2.75rem;background:linear-gradient(to bottom, transparent, #fff);pointer-events:none}#content label.fold-rows-label{display:flex;justify-content:center;margin-top:0.25rem;margin-bottom:1.5rem;font-size:0.75rem;font-weight:500;color:var(--vlm-muted);cursor:pointer}#content input.fold-rows:checked+[data-table-wrapper=\"true\"]+label.fold-rows-label .when-closed,#content input.fold-rows:not(:checked)+[data-table-wrapper=\"true\"]+label.fold-rows-label .when-open{display:none}#content [data-component-part=\"tabs-list\"]{margin-top:1.75rem!important;gap:1.75rem!important}#content [data-component-part=\"tab-button\"]{padding-top:0.85rem!important;padding-bottom:0.7rem!important;border-bottom-width:2px!important;color:var(--vlm-muted)!important;font-size:1rem!important;font-weight:500!important;line-height:1.5rem!important}#content [data-component-part=\"tab-button\"]:hover{color:var(--vlm-navy)!important}#content [data-component-part=\"tab-button\"][data-active=\"true\"]{color:var(--vlm-navy)!important;border-bottom-color:var(--vlm-navy)!important}p,li{color:var(--vlm-muted);letter-spacing:-0.01em}#navigation-items .sidebar-group-header,#navigation-items .sidebar-group-header .sidebar-title{font-family:'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:11px;font-weight:500;letter-spacing:0.12em;text-transform:uppercase;color:var(--vlm-muted)}a{color:var(--vlm-primary);transition:color 200ms ease-out, opacity 200ms ease-out}a:hover{color:var(--vlm-primary-hover)}.prose a,article a{text-decoration-color:color-mix(in srgb, var(--vlm-primary) 35%, transparent);text-underline-offset:3px;transition:text-decoration-color 200ms ease-out, color 200ms ease-out}.prose a:hover,article a:hover{text-decoration-color:var(--vlm-primary)}#navbar a[href=\"https://app.vlm.run\"],.navbar a[href=\"https://app.vlm.run\"],header a[href=\"https://app.vlm.run\"]{border-radius:20px!important;border:1px solid var(--vlm-primary-border)!important;background-color:var(--vlm-primary-mid)!important;color:#fff!important;box-shadow:var(--vlm-shadow-btn);transition:transform 300ms ease-out,\n box-shadow 300ms ease-out,\n background-color 300ms ease-out,\n opacity 300ms ease-out}#navbar a[href=\"https://app.vlm.run\"]:hover,.navbar a[href=\"https://app.vlm.run\"]:hover,header a[href=\"https://app.vlm.run\"]:hover{transform:translateY(-1px);background-color:var(--vlm-primary-dark)!important;opacity:0.95}#navigation-items a,#sidebar a,nav[aria-label=\"Sidebar\"] a{color:var(--vlm-navy)}#navigation-items a:hover,#sidebar a:hover,nav[aria-label=\"Sidebar\"] a:hover{color:var(--vlm-primary)}#navigation-items a[aria-current=\"page\"],#navigation-items a[data-active=\"true\"],#sidebar a[aria-current=\"page\"],#sidebar a[data-active=\"true\"],nav[aria-label=\"Sidebar\"] a[aria-current=\"page\"]{color:var(--vlm-primary)!important;font-weight:500}#navigation-items li li>a,#navigation-items li li>div>a,#navigation-items li li>button,#navigation-items li li>div>button{padding-left:2.5rem!important}#navigation-items li li li>a,#navigation-items li li li>div>a,#navigation-items li li li>button,#navigation-items li li li>div>button{padding-left:3.5rem!important}#content-side-layout:has(#table-of-contents){width:max-content!important;max-width:13rem!important;margin-left:0!important;margin-right:0.75rem!important;padding-right:0!important;align-items:flex-end!important;flex:0 0 auto!important;box-sizing:border-box!important}@media (min-width: 1280px){#content-area{width:auto!important;max-width:none!important;flex:1 1 auto!important;margin-left:0!important;margin-right:0!important;padding-left:2rem!important;padding-right:2rem!important}#content-area:has(#content)>header,#content{width:100%;max-width:48rem;margin-left:auto!important;margin-right:auto!important}}#table-of-contents-layout{width:max-content!important;max-width:13rem!important;margin-left:auto!important;padding-left:0!important;padding-right:0!important}#table-of-contents{width:max-content!important;max-width:13rem!important}#content-side-layout:has(#table-of-contents) h2{font-family:'Aeonik Pro', ui-sans-serif, system-ui, sans-serif!important;font-size:0.8125rem!important;line-height:1.25rem!important;font-weight:500!important;letter-spacing:0.01em!important;color:var(--vlm-muted)!important}#table-of-contents-content a,#table-of-contents a{font-size:0.8125rem!important;line-height:1.25rem!important;color:var(--vlm-muted)!important}#content-area{width:auto!important;max-width:none!important}#content{max-width:48rem}#content li{text-wrap:pretty}#toc a[aria-current=\"true\"],#toc a[aria-current=\"location\"],#toc a[data-active=\"true\"],nav[aria-label=\"On this page\"] a[aria-current=\"true\"],nav[aria-label=\"On this page\"] a[aria-current=\"location\"],nav[aria-label=\"On this page\"] a[data-active=\"true\"],#table-of-contents a[aria-current=\"true\"],#table-of-contents a[aria-current=\"location\"],#table-of-contents a[data-active=\"true\"]{color:var(--vlm-toc-active)!important;font-weight:500;box-shadow:none!important;border:none!important;padding-left:0!important}.card,[class*=\"card\"][role=\"link\"],a.card{background-color:#ffffff;border:1px solid var(--vlm-border);border-radius:12px;transition:transform 300ms ease-out,\n border-color 300ms ease-out,\n box-shadow 300ms ease-out}.card:hover,[class*=\"card\"][role=\"link\"]:hover,a.card:hover{transform:translateY(-1px);border-color:var(--vlm-primary);box-shadow:0 4px 12px -4px color-mix(in srgb, var(--vlm-primary) 20%, transparent)}.card-demo{color:var(--vlm-primary-mid);background-color:var(--vlm-primary-tint);border-color:var(--vlm-primary-tint)}.callout-info,[role=\"note\"][data-type=\"info\"],[role=\"note\"][data-type=\"note\"]{background-color:var(--vlm-primary-badge);border-color:var(--vlm-border);color:var(--vlm-navy)}.callout-tip,[role=\"note\"][data-type=\"tip\"]{background-color:color-mix(in srgb, var(--vlm-cap-green) 18%, white);border-color:color-mix(in srgb, var(--vlm-cap-green) 45%, white);color:var(--vlm-navy)}pre,[class*=\"code-block\"] pre{border:0;border-radius:0;background:transparent}:not(pre)>code{background-color:#F0F2F5;color:var(--vlm-navy);padding:0.05rem 0.15rem;border-radius:4px;font-size:0.875em}#content a code,#header a code{color:inherit}#header .eyebrow{display:none}#content>:is(h2,h3,h4)+[data-table-wrapper]{margin-top:0!important;padding-top:0!important}#content>:is(h2,h3,h4)+[data-table-wrapper] table{margin-top:0}table{width:100%;margin:1.5rem 0;border:1px solid var(--vlm-border)!important;border-radius:6px;border-collapse:separate!important;border-spacing:0!important;background-color:#ffffff;font-size:0.875rem;color:var(--vlm-navy)}thead th{background-color:var(--vlm-surface);border:0!important;border-bottom:1px solid var(--vlm-border)!important;padding:0.7rem 1rem!important;font-family:'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:11px;font-weight:500;letter-spacing:0.12em;text-transform:uppercase;color:var(--vlm-navy);vertical-align:middle}thead th .unit-help{display:inline-flex;align-items:center;justify-content:center;width:0.875rem;height:0.875rem;margin-left:0.35rem;border:1px solid var(--vlm-border);border-radius:999px;background:#fff;color:var(--vlm-muted);font-family:'Aeonik Pro', ui-sans-serif, system-ui, sans-serif;font-size:0.625rem;font-weight:600;letter-spacing:0;text-transform:none;line-height:1;text-decoration:none;vertical-align:1px;cursor:help}thead th button:has(.unit-help){display:inline-flex;align-items:center;margin:0;padding:0;border:0;background:transparent;color:inherit;font:inherit;letter-spacing:0;text-transform:none;vertical-align:middle;cursor:help}thead tr:first-child th:first-child{border-top-left-radius:6px}thead tr:first-child th:last-child{border-top-right-radius:6px}tbody tr:last-child td:first-child{border-bottom-left-radius:6px}tbody tr:last-child td:last-child{border-bottom-right-radius:6px}thead tr+tr th{border-bottom:1px solid var(--vlm-border)!important;padding-top:0.5rem!important;padding-bottom:0.75rem!important;font-size:10.5px}thead th[align=\"left\"]{text-align:left}thead th[align=\"center\"]{text-align:center}thead th[align=\"right\"]{text-align:right}thead th code{background:transparent!important;color:var(--vlm-navy)!important;padding:0!important;font-size:inherit!important;letter-spacing:0.12em!important;text-transform:uppercase!important}tbody tr{background-color:#ffffff}tbody td{border:0!important;border-bottom:1px solid var(--vlm-border)!important;padding:0.7rem 1rem!important;vertical-align:middle;color:var(--vlm-navy);line-height:1.55}tbody td:has(br),tbody td:has(ul),tbody td:has(p){vertical-align:top}tbody td ul{margin:0;padding-left:1.25rem}tbody td li+li{margin-top:0.35em}tbody td li kbd{font-family:'Geist Mono', ui-monospace, monospace;font-weight:600;font-size:0.8125rem;line-height:1.3;letter-spacing:-0.01em;color:var(--vlm-navy);background:transparent;border:1px solid var(--vlm-border);padding:0.05rem 0.3rem;margin:0;border-radius:3px;white-space:nowrap;box-shadow:none!important;text-shadow:none;filter:none;-webkit-box-shadow:none!important}table code{white-space:nowrap}tbody tr:last-child td{border-bottom:0!important}thead th:first-child,tbody td:first-child{padding-left:1.125rem!important}thead th:last-child,tbody td:last-child{padding-right:1.125rem!important}.rotated-row-headers thead th:first-child,.rotated-row-headers tbody td:first-child{padding-left:0.5rem!important;padding-right:0.5rem!important}.rotated-row-headers tbody td:first-child{border-right:1px solid var(--vlm-border)!important}tbody td:first-child,tbody td[rowspan]+td{font-weight:500;color:var(--vlm-navy)}tbody td[align=\"center\"],tbody td[align=\"right\"]{font-weight:500;color:var(--vlm-navy)}table code{font-family:'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:13px;font-weight:500}td[align=\"left\"]{text-align:left}td[align=\"center\"]{text-align:center}td[align=\"right\"]{text-align:right}tbody td code{background:transparent!important;color:inherit!important;padding:0!important;font-size:inherit!important;border-radius:0!important;font-weight:inherit!important}.accordion table,[data-accordion-content] table{margin:0.75rem 0;font-size:0.8125rem}.accordion tbody td,[data-accordion-content] tbody td,.accordion thead th,[data-accordion-content] thead th{padding:0.75rem 1rem!important}.accordion thead th:first-child,[data-accordion-content] thead th:first-child,.accordion tbody td:first-child,[data-accordion-content] tbody td:first-child{padding-left:1.25rem!important}.accordion thead th:last-child,[data-accordion-content] thead th:last-child,.accordion tbody td:last-child,[data-accordion-content] tbody td:last-child{padding-right:1.25rem!important}.gateway-models-catalog table{table-layout:fixed;width:100%;font-size:0.8125rem}.gateway-models-catalog thead th{padding:0.5rem 0.625rem!important;font-size:10px;letter-spacing:0.08em;line-height:1.35;white-space:normal;vertical-align:bottom}.gateway-models-catalog tbody td{padding:0.5rem 0.625rem!important;font-size:0.8125rem;line-height:1.45;vertical-align:top}.gateway-models-catalog thead th:first-child,.gateway-models-catalog tbody td:first-child{width:26%;padding-left:0.75rem!important;white-space:normal;word-break:break-word}.gateway-models-catalog thead th:nth-child(2),.gateway-models-catalog tbody td:nth-child(2){width:4.75rem;max-width:4.75rem;white-space:normal;word-break:break-word;hyphens:auto;text-align:center;font-size:0.75rem;line-height:1.35}.gateway-models-catalog table code{white-space:normal;word-break:break-word;font-size:0.75rem}.gateway-models-catalog tbody td:first-child a{word-break:break-word}.gateway-models-catalog thead th:last-child,.gateway-models-catalog tbody td:last-child{padding-right:0.75rem!important}html.dark table{background-color:transparent;border-color:var(--vlm-dark-border)!important}html.dark thead tr,html.dark thead tr th,html.dark tbody tr{background-color:transparent}html.dark thead th,html.dark tbody td{color:inherit;border-color:var(--vlm-dark-border)!important}.integration-hero{width:100%;aspect-ratio:1024 / 500;background-image:url('/assets/blog-backdrop.png');background-size:cover;background-position:center;border:1px solid var(--vlm-border);border-radius:8px;display:flex;align-items:center;justify-content:center;gap:4%;margin:1.5rem 0 2rem;overflow:hidden}.integration-hero-tile{width:17.6%;aspect-ratio:1 / 1;background-color:rgba(255, 255, 255, 0.96);border:1px solid var(--vlm-border);border-radius:12px;box-shadow:0 1px 2px rgba(16, 42, 86, 0.04),\n 0 4px 12px rgba(31, 90, 202, 0.05);overflow:hidden}.integration-hero-tile{display:flex;align-items:center;justify-content:center}.integration-hero-tile img,.integration-hero-tile svg{display:block;width:60%;height:60%;max-width:60%;margin:0!important;object-fit:contain;object-position:center}.integration-hero-tile:has(img[alt=\"n8n\"]) img{width:90%;height:90%;max-width:90%}.integration-hero-tile:has(img[alt=\"Zapier\"]) img{width:56%;height:56%;max-width:56%}.integration-hero-tile:has(img[alt=\"MongoDB\"]) img{width:88%;height:88%;max-width:88%}.integration-hero-tile:has(img[alt=\"Voxel51 FiftyOne\"]) img{width:68%;height:68%;max-width:68%}.platform-figure{position:relative;border:1px solid var(--vlm-border);border-radius:8px;padding:3.5% 3% 56px;margin:1.5rem 0 2rem;overflow:hidden;background-color:#ffffff}.platform-figure::before{content:\"\";position:absolute;inset:0;background-image:url('/images/platform-background.png');background-size:cover;background-position:center;background-repeat:no-repeat;opacity:0.6;pointer-events:none;z-index:0}.platform-figure>*,.platform-figure img{position:relative;z-index:1}.platform-figure img{display:block;width:100%;height:auto;border-radius:16px;border:1px solid var(--vlm-border);box-shadow:0 1px 2px rgba(16, 42, 86, 0.10),\n 0 12px 32px rgba(31, 90, 202, 0.14)}.platform-card-grid .card img,.platform-card-grid [class*=\"card\"][role=\"link\"] img{background-color:#ffffff;background-image:url('/images/platform-background.png');background-size:cover;background-position:center;background-repeat:no-repeat;padding:14px;box-sizing:border-box;border-radius:10px 10px 0 0;border:1px solid var(--vlm-border);border-bottom:0;box-shadow:0 1px 2px rgba(16, 42, 86, 0.05)}.domain-column{width:240px;display:inline-block}.function-column{width:240px;display:inline-block}.allowed-inputs-column{width:160px;display:inline-block}.description-column{width:100%;display:inline-block}.tag{padding:2px 8px;border-radius:12px;font-size:0.9em;font-weight:500;display:inline-block;margin-right:8px;margin-bottom:4px}.tag-document{background:color-mix(in srgb, var(--vlm-cap-green) 22%, white);color:#2F6B14}.tag-image{background:color-mix(in srgb, var(--vlm-cap-blue) 22%, white);color:var(--vlm-primary-dark)}.tag-video{background:color-mix(in srgb, var(--vlm-cap-purple) 22%, white);color:#5A2BB8}.tag-audio{background:var(--vlm-primary-badge);color:var(--vlm-primary-dark)}.tag-url{background:var(--vlm-primary-badge);color:var(--vlm-primary-dark)}.tag-ref{background:color-mix(in srgb, var(--vlm-cap-purple) 14%, white);color:#5A2BB8}.no-scrollbar{scrollbar-width:none;-ms-overflow-style:none}.no-scrollbar::-webkit-scrollbar{display:none}.glass{background:rgba(255, 255, 255, 0.05);border:1px solid rgba(255, 255, 255, 0.1)}.shadow-btn{box-shadow:var(--vlm-shadow-btn)}#footer{flex-wrap:wrap;row-gap:1.25rem}#footer::after{content:var(--vlm-docs-version, \"\");flex-basis:100%;order:99;font-family:'Geist Mono', ui-monospace, monospace;font-size:12px;letter-spacing:0.02em;color:var(--vlm-muted)}.hero-video{display:block;width:100%;height:auto;border-radius:6px;background:var(--vlm-navy-dark)}p:has(>.changelog-tag:first-child),span:has(>.changelog-tag:first-child){padding-left:88px;text-indent:-88px}.changelog-tag{display:inline-block;box-sizing:border-box;width:76px;margin-right:8px;padding:1px 0;text-align:center;text-indent:0;border:1px solid var(--vlm-border);border-radius:4px;background:var(--vlm-primary-badge);color:var(--vlm-muted);font-family:'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:11px;font-weight:500;letter-spacing:0.08em;line-height:1.5;text-transform:uppercase;vertical-align:1px}.support-dot{color:var(--vlm-primary-light)}html:not([data-legacy=\"1\"]) #navigation-items>div:has(a[href=\"/api-reference/structured-extraction\"]){display:none}"}],"page":{"pagePath":"api-reference/v1/get-artifact-by-id","slug":"/api-reference/v1/get-artifact-by-id","pageMetadata":{"title":"Get Artifact","openapi":"https://api.vlm.run/openapi.json GET /v1/artifacts","description":"Retrieve an artifact by session ID or execution ID.","href":"/api-reference/v1/get-artifact-by-id"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve an artifact by session ID or execution ID.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Retrieve the raw content of an artifact using either a `,_jsx(_components.code,{children:`session_id`}),` (for chat completions) or an `,_jsx(_components.code,{children:`execution_id`}),` (for agent executions), along with the `,_jsx(_components.code,{children:`object_id`}),` from the response. Artifacts are binary objects generated during agent interactions, such as images, videos, audio files, and documents.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`For a comprehensive guide on working with artifacts, including usage patterns and examples, see the `,_jsx(_components.a,{href:`/agents/artifacts`,children:`Artifacts Guide`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`object_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Object ID for the artifact (format: `,_jsx(_components.code,{children:`\u003ctype>_\u003c6-hex-chars>`}),`, e.g., `,_jsx(_components.code,{children:`img_a1b2c3`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`session_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Session ID from chat completions (mutually exclusive with `,_jsx(_components.code,{children:`execution_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`execution_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Execution ID from agent executions (mutually exclusive with `,_jsx(_components.code,{children:`session_id`}),`)`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Either `,_jsx(_components.code,{children:`session_id`}),` or `,_jsx(_components.code,{children:`execution_id`}),` must be provided, but not both. Use `,_jsx(_components.code,{children:`session_id`}),` for artifacts from chat completions and `,_jsx(_components.code,{children:`execution_id`}),` for artifacts from agent executions.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`object-reference-format`,children:`Object Reference Format`}),`\n`,_jsxs(_components.p,{children:[`Object references follow the format: `,_jsx(_components.code,{children:`\u003ctype_prefix>_\u003c6-digit-hex-string>`}),` (e.g., `,_jsx(_components.code,{children:`img_a1b2c3`}),`).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Artifact Type`}),_jsx(_components.th,{children:`Prefix`}),_jsx(_components.th,{children:`Reference Type`}),_jsx(_components.th,{children:`Python Return Type`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`img_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ImageRef`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PIL.Image.Image`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Video`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`vid_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VideoRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (mp4)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`aud_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AudioRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (mp3)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Document`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`doc_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DocumentRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (pdf)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Reconstruction`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`recon_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ReconRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (spz)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`URL`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`url_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UrlRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (any of the above)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Array`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`arr_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ArrayRef`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`np.ndarray`})})]})]})]}),`\n`,_jsx(_components.p,{children:`The Python SDK provides convenience methods that automatically convert artifacts to the appropriate Python types.`}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns the raw binary content of the artifact with the appropriate content type based on the artifact type.`}),`\n`,_jsx(Heading,{level:`2`,id:`get-artifact-by-session-id`,children:`Get Artifact by Session ID`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`session_id`}),` to retrieve artifacts from chat completion responses.`]}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`get-artifact-by-execution-id`,children:`Get Artifact by Execution ID`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`execution_id`}),` to retrieve artifacts from agent execution responses.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`36`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`36`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:` PIL`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Image`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` pydantic `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` BaseModel, Field`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.client.types `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` AgentExecutionConfig, AgentExecutionResponse, ImageUrl`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.types `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ImageRef, MessageContent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cVLMRUN_API_KEY>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Define typed inputs and response model`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:` ExecutionInputs`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:`BaseModel`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` image: MessageContent `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Field(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"The input image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:` ImageResponse`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:`BaseModel`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` image: ImageRef `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Field(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"The processed image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Execute an agent`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution: AgentExecutionResponse `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.agent.execute(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image/blur-image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` inputs`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ExecutionInputs(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` image`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`MessageContent(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`type`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image_url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`image_url`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ImageUrl(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/photo.jpg\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`))`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ),`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` config`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`AgentExecutionConfig(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` prompt`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"Blur the entire image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` response_model`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ImageResponse`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Wait for completion`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.executions.wait(execution.id, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`timeout`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#B5CEA8`},children:`180`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Parse the response and retrieve the artifact using execution_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ImageResponse.model_validate(execution.response)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`image: Image.Image `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.artifacts.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` execution_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution.id,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` object_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result.image.id,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`13`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"vlmrun\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:` VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` baseURL:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vlm.run/v1\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cVLMRUN_API_KEY>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`// Retrieve the artifact using execution_id and object_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` artifact`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifacts`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`get`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` executionId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cEXECUTION_ID>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` objectId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"img_a1b2c3\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifact`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"dark-plus"}},"config":{},"pageMetadata":{"title":"Get Artifact","openapi":"https://api.vlm.run/openapi.json GET /v1/artifacts","description":"Retrieve an artifact by session ID or execution ID.","href":"/api-reference/v1/get-artifact-by-id"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info,Note,RequestExample,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Retrieve the raw content of an artifact using either a `,_jsx(_components.code,{children:`session_id`}),` (for chat completions) or an `,_jsx(_components.code,{children:`execution_id`}),` (for agent executions), along with the `,_jsx(_components.code,{children:`object_id`}),` from the response. Artifacts are binary objects generated during agent interactions, such as images, videos, audio files, and documents.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`For a comprehensive guide on working with artifacts, including usage patterns and examples, see the `,_jsx(_components.a,{href:`/agents/artifacts`,children:`Artifacts Guide`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`object_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Object ID for the artifact (format: `,_jsx(_components.code,{children:`\u003ctype>_\u003c6-hex-chars>`}),`, e.g., `,_jsx(_components.code,{children:`img_a1b2c3`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`session_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Session ID from chat completions (mutually exclusive with `,_jsx(_components.code,{children:`execution_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`execution_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Execution ID from agent executions (mutually exclusive with `,_jsx(_components.code,{children:`session_id`}),`)`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Either `,_jsx(_components.code,{children:`session_id`}),` or `,_jsx(_components.code,{children:`execution_id`}),` must be provided, but not both. Use `,_jsx(_components.code,{children:`session_id`}),` for artifacts from chat completions and `,_jsx(_components.code,{children:`execution_id`}),` for artifacts from agent executions.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`object-reference-format`,children:`Object Reference Format`}),`\n`,_jsxs(_components.p,{children:[`Object references follow the format: `,_jsx(_components.code,{children:`\u003ctype_prefix>_\u003c6-digit-hex-string>`}),` (e.g., `,_jsx(_components.code,{children:`img_a1b2c3`}),`).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Artifact Type`}),_jsx(_components.th,{children:`Prefix`}),_jsx(_components.th,{children:`Reference Type`}),_jsx(_components.th,{children:`Python Return Type`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`img_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ImageRef`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PIL.Image.Image`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Video`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`vid_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VideoRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (mp4)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`aud_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AudioRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (mp3)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Document`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`doc_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DocumentRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (pdf)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Reconstruction`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`recon_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ReconRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (spz)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`URL`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`url_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UrlRef`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Path`}),` (any of the above)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Array`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`arr_`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ArrayRef`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`np.ndarray`})})]})]})]}),`\n`,_jsx(_components.p,{children:`The Python SDK provides convenience methods that automatically convert artifacts to the appropriate Python types.`}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns the raw binary content of the artifact with the appropriate content type based on the artifact type.`}),`\n`,_jsx(Heading,{level:`2`,id:`get-artifact-by-session-id`,children:`Get Artifact by Session ID`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`session_id`}),` to retrieve artifacts from chat completion responses.`]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`34`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`34`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:` PIL`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Image`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` pydantic `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` BaseModel, Field`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.types `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ImageRef`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cVLMRUN_API_KEY>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Define a response model with an ImageRef field`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:` BlurredImageResponse`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:`BaseModel`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` image: ImageRef `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Field(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"The blurred image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Make a chat completion request that generates an image artifact`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.agent.completions.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` model`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"vlmrun-orion-2:auto\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` messages`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`[`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"role\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"user\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"Blur all the faces in this image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image_url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image_url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/photo.jpg\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`}}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` response_format`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"json_schema\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"schema\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`: BlurredImageResponse.model_json_schema()},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Parse the response to get the artifact reference`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` BlurredImageResponse.model_validate_json(response.choices[`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`].message.content)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Retrieve the artifact using session_id and object_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`image: Image.Image `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.artifacts.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` session_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`response.session_id,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` object_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result.image.id,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`13`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"vlmrun\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:` VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` baseURL:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vlm.run/v1\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cVLMRUN_API_KEY>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`// Retrieve the artifact using session_id and object_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` artifact`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifacts`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`get`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` sessionId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cSESSION_ID>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` objectId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"img_a1b2c3\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifact`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`get-artifact-by-execution-id`,children:`Get Artifact by Execution ID`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`execution_id`}),` to retrieve artifacts from agent execution responses.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`36`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`36`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:` PIL`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Image`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` pydantic `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` BaseModel, Field`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.client.types `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` AgentExecutionConfig, AgentExecutionResponse, ImageUrl`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` vlmrun.types `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ImageRef, MessageContent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` VLMRun(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cVLMRUN_API_KEY>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Define typed inputs and response model`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:` ExecutionInputs`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:`BaseModel`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` image: MessageContent `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Field(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"The input image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:` ImageResponse`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#4EC9B0`},children:`BaseModel`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` image: ImageRef `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` Field(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"The processed image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Execute an agent`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution: AgentExecutionResponse `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.agent.execute(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image/blur-image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` inputs`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ExecutionInputs(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` image`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`MessageContent(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`type`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"image_url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`image_url`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ImageUrl(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/photo.jpg\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`))`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ),`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` config`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`AgentExecutionConfig(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` prompt`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:`\"Blur the entire image\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` response_model`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`ImageResponse`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Wait for completion`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.executions.wait(execution.id, `}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:`timeout`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#B5CEA8`},children:`180`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`# Parse the response and retrieve the artifact using execution_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` ImageResponse.model_validate(execution.response)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`image: Image.Image `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` client.artifacts.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` execution_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`execution.id,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#9CDCFE`},children:` object_id`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`result.image.id,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`13`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light dark-plus`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#24292e`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"vlmrun\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:` VlmRun`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` baseURL:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vlm.run/v1\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cVLMRUN_API_KEY>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A9955`},children:`// Retrieve the artifact using execution_id and object_id`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#4FC1FF`},children:` artifact`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifacts`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`get`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` executionId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cEXECUTION_ID>\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:` objectId:`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#CE9178`},children:` \"img_a1b2c3\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#9CDCFE`},children:`artifact`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"dark-plus"}},"config":{},"pageMetadata":{"title":"Get Artifact","openapi":"https://api.vlm.run/openapi.json GET /v1/artifacts","description":"Retrieve an artifact by session ID or execution ID.","href":"/api-reference/v1/get-artifact-by-id"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Object Reference Format","slug":"object-reference-format","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Get Artifact by Session ID","slug":"get-artifact-by-session-id","depth":2,"children":[]},{"title":"Get Artifact by Execution ID","slug":"get-artifact-by-execution-id","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light dark-plus\" style=\"background-color:#fff;--shiki-dark-bg:#0B0C0E;color:#24292e;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"34\">\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#D4D4D4\"> PIL\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\"> import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> Image\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> pydantic \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> BaseModel, Field\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> vlmrun.client \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> VLMRun\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> vlmrun.types \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> ImageRef\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">client \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> VLMRun(\u003c/span>\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\">api_key\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"\u0026#x3C;VLMRUN_API_KEY>\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6A737D;--shiki-dark:#6A9955\"># Define a response model with an ImageRef field\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#569CD6\">class\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#4EC9B0\"> BlurredImageResponse\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#4EC9B0\">BaseModel\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">):\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> image: ImageRef \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> Field(\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#D4D4D4\">...\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\">description\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"The blurred image\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6A737D;--shiki-dark:#6A9955\"># Make a chat completion request that generates an image artifact\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> client.agent.completions.create(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\"> model\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"vlmrun-orion-2:auto\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\"> messages\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">[\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"role\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"user\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"content\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"text\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"text\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"Blur all the faces in this image\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"image_url\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"image_url\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"url\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"https://example.com/photo.jpg\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">}}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\"> response_format\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"json_schema\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\">\"schema\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">: BlurredImageResponse.model_json_schema()},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6A737D;--shiki-dark:#6A9955\"># Parse the response to get the artifact reference\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">result \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> BlurredImageResponse.model_validate_json(response.choices[\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">].message.content)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6A737D;--shiki-dark:#6A9955\"># Retrieve the artifact using session_id and object_id\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">image: Image.Image \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> client.artifacts.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\"> session_id\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">response.session_id,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#E36209;--shiki-dark:#9CDCFE\"> object_id\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">result.image.id,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Node.js","html":"\u003cpre class=\"shiki shiki-themes github-light dark-plus\" style=\"background-color:#fff;--shiki-dark-bg:#0B0C0E;color:#24292e;--shiki-dark:#D4D4D4\" language=\"typescript\">\u003ccode language=\"typescript\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\">VlmRun\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\"> } \u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\">from\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"vlmrun\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#4FC1FF\"> client\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#DCDCAA\"> VlmRun\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\"> baseURL:\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"https://api.vlm.run/v1\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\"> apiKey:\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"\u0026#x3C;VLMRUN_API_KEY>\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6A737D;--shiki-dark:#6A9955\">// Retrieve the artifact using session_id and object_id\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#4FC1FF\"> artifact\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\"> client\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\">artifacts\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#DCDCAA\">get\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\"> sessionId:\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"\u0026#x3C;SESSION_ID>\"\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\"> objectId:\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#CE9178\"> \"img_a1b2c3\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#9CDCFE\">artifact\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":["/_mintlify/custom/autonomiai/a2d609d7d372c9af/unifygtm.js","/_mintlify/custom/autonomiai/12b17cdd767d0ac7/legacy.js"],"openApiReferenceData":{"operation":{"tags":["artifacts"],"summary":"List or Get Artifacts","description":"Retrieve an artifact by session ID or execution ID.","operationId":"artifacts_v1_artifacts_get","security":["e79bf143-12ce-4d18-8677-08861c35c6bc"],"parameters":["e963fd5b-8900-402c-9ace-b2c5fd034d02","fb7d00e3-e546-4d72-84d1-2e83b73a5bb5","ca429543-138a-4fd1-9d75-b65e00e90ce0","269b646b-c338-44d9-ba0a-018200971b03","7b092853-0653-4db2-8a94-ef7643be1d2f","e879a400-8f2a-4309-8388-61a4c2619883"],"responses":{"200":"d7effead-5296-4fbd-8948-55d0295030bb","422":"e8858d72-d284-4d80-af33-79340eef28ce"},"method":"get","type":"path","servers":[],"path":"/v1/artifacts","baseUrlOptions":[],"title":"List or Get Artifacts","codeSamples":[],"requestExampleLanguages":["python","javascript","ruby","bash"],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"python","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light dark-plus","style":{"backgroundColor":"#fff","--shiki-dark-bg":"#0B0C0E","color":"#24292e","--shiki-dark":"#D4D4D4"},"language":"python","children":{"type":"code","key":null,"ref":null,"props":{"language":"python","numberOfLines":"34","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#005CC5","--shiki-dark":"#D4D4D4"},"children":" PIL"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":" import"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" Image"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" pydantic "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" BaseModel, Field"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" vlmrun.client "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" VLMRun"}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" vlmrun.types "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" ImageRef"}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"client "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" VLMRun("}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":"api_key"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"\u003cVLMRUN_API_KEY>\""}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":")"}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#6A737D","--shiki-dark":"#6A9955"},"children":"# Define a response model with an ImageRef field"}}}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#569CD6"},"children":"class"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#6F42C1","--shiki-dark":"#4EC9B0"},"children":" BlurredImageResponse"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"("}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#6F42C1","--shiki-dark":"#4EC9B0"},"children":"BaseModel"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"):"}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" image: ImageRef "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" Field("}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#005CC5","--shiki-dark":"#D4D4D4"},"children":"..."}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":"description"}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"The blurred image\""}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":")"}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#6A737D","--shiki-dark":"#6A9955"},"children":"# Make a chat completion request that generates an image artifact"}}}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"response "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" client.agent.completions.create("}}]}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":" model"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"vlmrun-orion-2:auto\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":" messages"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"["}}]}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" {"}}}},"\n",{"type":"span","key":"32","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"role\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"user\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"34","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"content\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": ["}}]}},"\n",{"type":"span","key":"36","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" {"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"type\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"text\""}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"text\""}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"Blur all the faces in this image\""}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"},"}}]}},"\n",{"type":"span","key":"38","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" {"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"type\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"image_url\""}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"image_url\""}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": {"}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"url\""}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"9","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"https://example.com/photo.jpg\""}},{"type":"span","key":"10","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"}}"}}]}},"\n",{"type":"span","key":"40","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" ]"}}}},"\n",{"type":"span","key":"42","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"44","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" ],"}}}},"\n",{"type":"span","key":"46","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":" response_format"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"{"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"type\""}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"json_schema\""}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":"\"schema\""}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":": BlurredImageResponse.model_json_schema()},"}}]}},"\n",{"type":"span","key":"48","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":")"}}}},"\n",{"type":"span","key":"50","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"52","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#6A737D","--shiki-dark":"#6A9955"},"children":"# Parse the response to get the artifact reference"}}}},"\n",{"type":"span","key":"54","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"result "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" BlurredImageResponse.model_validate_json(response.choices["}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#005CC5","--shiki-dark":"#B5CEA8"},"children":"0"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"].message.content)"}}]}},"\n",{"type":"span","key":"56","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"58","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#6A737D","--shiki-dark":"#6A9955"},"children":"# Retrieve the artifact using session_id and object_id"}}}},"\n",{"type":"span","key":"60","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"image: Image.Image "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" client.artifacts.get("}}]}},"\n",{"type":"span","key":"62","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":" session_id"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"response.session_id,"}}]}},"\n",{"type":"span","key":"64","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#E36209","--shiki-dark":"#9CDCFE"},"children":" object_id"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":"="}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"result.image.id,"}}]}},"\n",{"type":"span","key":"66","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":")"}}}},"\n"]}}}},"filename":"Python"},{"dropdown":false,"language":"typescript","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light dark-plus","style":{"backgroundColor":"#fff","--shiki-dark-bg":"#0B0C0E","color":"#24292e","--shiki-dark":"#D4D4D4"},"language":"typescript","children":{"type":"code","key":null,"ref":null,"props":{"language":"typescript","numberOfLines":"13","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"import"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" { "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":"VlmRun"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":" } "}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":"from"}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"vlmrun\""}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":";"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#569CD6"},"children":"const"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#005CC5","--shiki-dark":"#4FC1FF"},"children":" client"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":" ="}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#569CD6"},"children":" new"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#6F42C1","--shiki-dark":"#DCDCAA"},"children":" VlmRun"}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"({"}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":" baseURL:"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"https://api.vlm.run/v1\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":" apiKey:"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"\u003cVLMRUN_API_KEY>\""}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"});"}}}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":null}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#6A737D","--shiki-dark":"#6A9955"},"children":"// Retrieve the artifact using session_id and object_id"}}}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#569CD6"},"children":"const"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#005CC5","--shiki-dark":"#4FC1FF"},"children":" artifact"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#D4D4D4"},"children":" ="}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#D73A49","--shiki-dark":"#C586C0"},"children":" await"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":" client"}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"."}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":"artifacts"}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"."}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#6F42C1","--shiki-dark":"#DCDCAA"},"children":"get"}},{"type":"span","key":"9","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"({"}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":" sessionId:"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"\u003cSESSION_ID>\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":" objectId:"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#032F62","--shiki-dark":"#CE9178"},"children":" \"img_a1b2c3\""}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"});"}}}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":"console"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"."}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#6F42C1","--shiki-dark":"#DCDCAA"},"children":"log"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":"("}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#9CDCFE"},"children":"artifact"}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#24292E","--shiki-dark":"#D4D4D4"},"children":");"}}]}},"\n"]}}}},"filename":"Node.js"}],"requestExampleType":"mdx","responseExampleType":"generated"},"dependencies":{"parameters":{"e963fd5b-8900-402c-9ace-b2c5fd034d02":{"name":"session_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Session Id","description":"Session ID for the artifacts","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Session Id","description":"Session ID for the artifacts","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Session ID for the artifacts"},"fb7d00e3-e546-4d72-84d1-2e83b73a5bb5":{"name":"execution_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Execution Id","description":"Execution ID for the artifacts","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Execution Id","description":"Execution ID for the artifacts","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Execution ID for the artifacts"},"ca429543-138a-4fd1-9d75-b65e00e90ce0":{"name":"object_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Object Id","description":"Object ID to retrieve a single artifact","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Object Id","description":"Object ID to retrieve a single artifact","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Object ID to retrieve a single artifact"},"269b646b-c338-44d9-ba0a-018200971b03":{"name":"filename","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Filename","description":"Workspace filename to retrieve a single artifact","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Filename","description":"Workspace filename to retrieve a single artifact","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Workspace filename to retrieve a single artifact"},"7b092853-0653-4db2-8a94-ef7643be1d2f":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of items to return when listing","default":100,"title":"Limit","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Maximum number of items to return when listing"},"e879a400-8f2a-4309-8388-61a4c2619883":{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of items to skip when listing","default":0,"title":"Offset","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Number of items to skip when listing"}},"responses":{"d7effead-5296-4fbd-8948-55d0295030bb":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"e8858d72-d284-4d80-af33-79340eef28ce":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e79bf143-12ce-4d18-8677-08861c35c6bc":{"HTTPBearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"https://api.vlm.run/openapi.json"},"subdomain":"autonomiai","siteName":"VLM Run","title":"Get Artifact - VLM Run","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T18:10:55.362Z","originalFileLocation":"api-reference/v1/get-artifact-by-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve an artifact by session ID or execution ID.\">\u003cmeta data-mint-head name=\"application-name\" content=\"VLM Run\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Artifact - VLM Run\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve an artifact by session ID or execution ID.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VLM Run\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://autonomiai.mintlify.site/_mintlify/api/og/v2?division=Files\u0026amp;title=Get+Artifact\u0026amp;description=Retrieve+an+artifact+by+session+ID+or+execution+ID.\u0026amp;theme=9e78e25362d3b3059041160c\u0026amp;signature=58436d797a4fcf864a81b0edc794abf663e03c02e82a727cb9cb4fc170ac70ca\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Artifact - VLM Run\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve an artifact by session ID or execution ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://autonomiai.mintlify.site/_mintlify/api/og/v2?division=Files\u0026amp;title=Get+Artifact\u0026amp;description=Retrieve+an+artifact+by+session+ID+or+execution+ID.\u0026amp;theme=9e78e25362d3b3059041160c\u0026amp;signature=58436d797a4fcf864a81b0edc794abf663e03c02e82a727cb9cb4fc170ac70ca\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/autonomiai/pD_ZZ-IBiToGpeSG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VLM Run\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1F5ACA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/get-artifact-by-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vlm.run/#organization\",\"name\":\"VLM Run\",\"url\":\"https://docs.vlm.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/autonomiai/0Yrk6nqaa_NlkPay/assets/logo/vlm-run-icon.svg?fit=max\u0026auto=format\u0026n=0Yrk6nqaa_NlkPay\u0026q=85\u0026s=fbea8392452b746e14273d7670a4f535\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vlm.run#website\",\"name\":\"VLM Run\",\"url\":\"https://docs.vlm.run\",\"publisher\":{\"@id\":\"https://docs.vlm.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id#webpage\",\"url\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id\",\"name\":\"Get Artifact\",\"description\":\"Retrieve an artifact by session ID or execution ID.\",\"dateModified\":\"2026-11-14T18:10:55.362Z\",\"isPartOf\":{\"@id\":\"https://docs.vlm.run#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Files\",\"item\":\"https://docs.vlm.run/api-reference/v1/files/post-file-upload\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Artifact\",\"item\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id#apireference\",\"headline\":\"Get Artifact\",\"name\":\"Get Artifact\",\"description\":\"Retrieve an artifact by session ID or execution ID.\",\"url\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vlm.run/api-reference/v1/get-artifact-by-id#webpage\"},\"dateModified\":\"2026-11-14T18:10:55.362Z\",\"publisher\":{\"@id\":\"https://docs.vlm.run/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vlm.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VLM Run\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VLM Run\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1/get-artifact-by-id.md","siteName":"VLM Run","nav":{"global":null,"tabs":[{"tab":"Gateway","icon":"network-wired","pages":[{"title":"Gateway","href":"/gateway/introduction"}]},{"tab":"Orion","icon":"robot","pages":[{"title":"Orion","href":"/agents/introduction"}]},{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/gateway/guides/document-ocr"}]},{"tab":"API reference","icon":"server","anchors":[{"anchor":"Gateway API","icon":"network-wired","pages":[{"title":"Gateway API","href":"/gateway/api-reference/get-health"}]},{"anchor":"Orion API","icon":"robot","groups":[{"group":"Getting started","pages":[{"title":"Overview","icon":"book","href":"/api-reference"},{"title":"Health","openapi":"https://api.vlm.run/openapi.json GET /v1/health","href":"/api-reference/v1/health"}]},{"group":"Chat Completions","pages":[{"title":"Chat Completions","openapi":"https://api.vlm.run/openapi.json POST /v1/openai/chat/completions","href":"/api-reference/v1/post-chat-completions"},{"title":"List models","openapi":"https://api.vlm.run/openapi.json GET /v1/models","href":"/api-reference/v1/get-models"}]},{"group":"Generate","pages":[{"title":"Structured Extraction","href":"/api-reference/structured-extraction"},{"title":"Image → JSON","openapi":"https://api.vlm.run/openapi.json POST /v1/image/generate","href":"/api-reference/v1/post-image-generate"},{"title":"Doc → JSON","openapi":"https://api.vlm.run/openapi.json POST /v1/document/generate","href":"/api-reference/v1/post-document-generate"},{"title":"Audio → JSON","openapi":"https://api.vlm.run/openapi.json POST /v1/audio/generate","href":"/api-reference/v1/post-audio-generate"},{"title":"Video → JSON","openapi":"https://api.vlm.run/openapi.json POST /v1/video/generate","href":"/api-reference/v1/post-video-generate"},{"title":"Get Prediction by ID","openapi":"https://api.vlm.run/openapi.json GET /v1/predictions/{id}","href":"/api-reference/v1/predictions/get-predictions-by-id"},{"title":"Get Predictions","openapi":"https://api.vlm.run/openapi.json GET /v1/predictions","href":"/api-reference/v1/predictions/get-predictions-list"}]},{"group":"Agents","pages":[{"title":"Lookup Agent","openapi":"https://api.vlm.run/openapi.json POST /v1/agent/lookup","href":"/api-reference/v1/post-agent-lookup"},{"title":"List Agents","openapi":"https://api.vlm.run/openapi.json GET /v1/agent","href":"/api-reference/v1/get-agent"},{"title":"Create Agent","openapi":"https://api.vlm.run/openapi.json POST /v1/agent/create","href":"/api-reference/v1/post-agent-create"},{"title":"Execute Agent","openapi":"https://api.vlm.run/openapi.json POST /v1/agent/execute","href":"/api-reference/v1/post-agent-execute"},{"title":"Get Execution by ID","openapi":"https://api.vlm.run/openapi.json GET /v1/agent/executions/{id}","href":"/api-reference/v1/get-agent-executions-by-id"},{"title":"List Executions","openapi":"https://api.vlm.run/openapi.json GET /v1/agent/executions","href":"/api-reference/v1/get-agent-executions"}]},{"group":"Files","pages":[{"title":"Upload File","openapi":"https://api.vlm.run/openapi.json POST /v1/files","href":"/api-reference/v1/files/post-file-upload"},{"title":"Get File by ID","openapi":"https://api.vlm.run/openapi.json GET /v1/files/{file_id}","href":"/api-reference/v1/files/get-files-by-id"},{"title":"List Files","openapi":"https://api.vlm.run/openapi.json GET /v1/files","href":"/api-reference/v1/files/get-files-list"},{"title":"Delete File","openapi":"https://api.vlm.run/openapi.json DELETE /v1/files/{file_id}","description":"Delete a file by ID. Only available for Pro and Enterprise users.","href":"/api-reference/v1/files/delete-file"},{"title":"Get Artifact","openapi":"https://api.vlm.run/openapi.json GET /v1/artifacts","href":"/api-reference/v1/get-artifact-by-id"}]},{"group":"Skills","pages":[{"title":"List Skills","openapi":"https://api.vlm.run/openapi.json GET /v1/skills","description":"List all skills from the database.\n\n- Authenticated user: returns their org's skills + public skills.\n- Guest user: returns public skills only (guest org has no skills).\n\nQuery parameters:\n- limit/offset: Pagination controls.\n- order_by: Sort field (created_at, updated_at, name). Default: created_at.\n- descending: Sort direction. Default: true.\n- grouped: When true, returns only the latest version of each skill name.","href":"/api-reference/v1/skills/get-skills-list"},{"title":"Lookup Skill","openapi":"https://api.vlm.run/openapi.json POST /v1/skills/lookup","href":"/api-reference/v1/skills/post-skill-lookup"},{"title":"Get Skill","openapi":"https://api.vlm.run/openapi.json GET /v1/skills/{skill_id}","href":"/api-reference/v1/skills/get-skill-by-id"},{"title":"Create Skill","openapi":"https://api.vlm.run/openapi.json POST /v1/skills/create","href":"/api-reference/v1/skills/post-skill-create"},{"title":"Update Skill","openapi":"https://api.vlm.run/openapi.json POST /v1/skills/{skill_id}/update","href":"/api-reference/v1/skills/post-skill-update"},{"title":"Get Skill Download URL","openapi":"https://api.vlm.run/openapi.json GET /v1/skills/{skill_id}/download","href":"/api-reference/v1/skills/get-skill-download"}]},{"group":"Feedback","pages":[{"title":"Submit Feedback","openapi":"https://api.vlm.run/openapi.json POST /v1/feedback/submit","href":"/api-reference/v1/post-submit-feedback"}]}]}]},{"tab":"Developers","icon":"code","pages":[{"title":"Developers","href":"/sdk-reference/getting-started"}]}]},"basePath":"","title":"Get Artifact - VLM Run","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}