Get asset metadata from remote URL

Retrieves metadata for an asset from a remote download URL without downloading the entire file. Supports various sources including CivitAI and other model repositories. Uses HEAD requests or API calls to fetch metadata efficiently. This endpoint is for previewing metadata before downloading, not for getting metadata of existing assets.

GET /api/assets/remote-metadata

Get asset metadata from remote URL

cURL

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

200

{
  "content_length": 4294967296,
  "content_type": "application/octet-stream",
  "filename": "realistic-vision-v5.safetensors",
  "name": "Realistic Vision v5.0",
  "tags": [
    "models",
    "checkpoint"
  ],
  "preview_image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
  "validation": {
    "is_valid": true,
    "errors": [
      {
        "code": "FORMAT_NOT_ALLOWED",
        "message": "File format \"PickleTensor\" is not allowed. Allowed formats: [SafeTensor]",
        "field": "format"
      }
    ],
    "warnings": [
      {
        "code": "FORMAT_NOT_ALLOWED",
        "message": "File format \"PickleTensor\" is not allowed. Allowed formats: [SafeTensor]",
        "field": "format"
      }
    ]
  }
}

授权

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

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

查询参数

url · string<uri> · 必填

Download URL to retrieve metadata from

示例:

"https://civitai.com/api/download/models/123456"

响应

200

application/json

Metadata retrieved successfully

content_length · integer<int64> · 必填

Size of the asset in bytes (-1 if unknown)

示例:

4294967296

content_type · string

MIME type of the asset

示例:

"application/octet-stream"

filename · string

Suggested filename for the asset from source

示例:

"realistic-vision-v5.safetensors"

name · string

Display name or title for the asset from source

示例:

"Realistic Vision v5.0"

tags · string[]

Tags for categorization from source

示例:

["models", "checkpoint"]

preview_image · string

Preview image as base64-encoded data URL

示例:

"data:image/jpeg;base64,/9j/4AAQSkZJRg..."

validation · object

Validation results for the file

Show child attributes