Get asset details

Retrieves detailed information about a specific asset

GET /api/assets/{id}

Get asset details

cURL

curl --request GET \
  --url https://cloud.comfy.org/api/assets/{id} \
  --header 'X-API-Key: <api-key>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "size": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "asset_hash": "<string>",
  "mime_type": "<string>",
  "tags": [
    "<string>"
  ],
  "user_metadata": {},
  "preview_url": "<string>",
  "preview_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "prompt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "last_access_time": "2023-11-07T05:31:56Z",
  "is_immutable": true
}

授权

X-API-Key · string · header · 必填

API key authentication. Generate an API key from your account settings at https://comfy.org/account. Pass the key in the X-API-Key header.

路径参数

id · string<uuid> · 必填

Asset ID

响应

200

application/json

Asset details retrieved successfully

id · string<uuid> · 必填

Unique identifier for the asset

name · string · 必填

Name of the asset file

size · integer<int64> · 必填

Size of the asset in bytes

created_at · string<date-time> · 必填

Timestamp when the asset was created

updated_at · string<date-time> · 必填

Timestamp when the asset was last updated

asset_hash · string

Blake3 hash of the asset content

mime_type · string

MIME type of the asset

tags · string[]

Tags associated with the asset

user_metadata · object

Custom user metadata for the asset

preview_url · string<uri>

URL for asset preview/thumbnail

preview_id · string<uuid> | null

ID of the preview asset if available

prompt_id · string<uuid> | null

ID of the job/prompt that created this asset, if available

last_access_time · string<date-time>

Timestamp when the asset was last accessed

is_immutable · boolean

Whether this asset is immutable (cannot be modified or deleted)