Sign in
assets

Fetch metadata for a remote asset URL

[cloud-only] Fetches and returns metadata (content type, size, filename) for a remote URL without downloading the full content.

get/api/assets/remote-metadata

Query parameters

urlstring uri required

URL to inspect

Response

Remote metadata

content_lengthinteger required

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

content_typestring

MIME type of the asset

filenamestring

Suggested filename for the asset from source

namestring

Display name or title for the asset from source

tagsstring[]

Tags for categorization from source

preview_imagestring

Preview image as base64-encoded data URL

Example response

{
  "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"
      }
    ]
  }
}

Changes