---
title: "Get asset metadata from remote URL"
method: GET
path: "/api/assets/remote-metadata"
tags: ["asset"]
---

# Get asset metadata from remote URL

`GET /api/assets/remote-metadata`

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.

## Query parameters

- `url` string, uri, required

## Response `200`

Metadata retrieved successfully

- AssetMetadataResponse
  - `content_length` integer, required — Size of the asset in bytes (-1 if unknown)
  - `content_type` string — MIME type of the asset
  - `filename` string — Suggested filename for the asset from source
  - `name` string — Display name or title for the asset from source
  - `tags` string[] — Tags for categorization from source
  - `preview_image` string — Preview image as base64-encoded data URL
  - `validation` ValidationResult
    - `is_valid` boolean, required — Overall validation status (true if all checks passed)
    - `errors` ValidationError[] — Blocking validation errors that prevent download
      - `code` string, required — Machine-readable error code
      - `message` string, required — Human-readable error message
      - `field` string, required — Field that failed validation
    - `warnings` ValidationError[] — Non-blocking validation warnings (informational only)
      - `code` string, required — Machine-readable error code
      - `message` string, required — Human-readable error message
      - `field` string, required — Field that failed validation

## Other responses

- `400` — Invalid URL or missing required parameter
- `401` — Unauthorized
- `422` — Failed to retrieve metadata from source
- `500` — Internal server error

---

[API](https://skmtc.net/ac/apis/comfy-api.md) · [All operations](https://skmtc.net/ac/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ac/comfy-api/versions/c1893dffe250/schema)