---
title: "Query VHS video metadata"
method: GET
path: "/api/vhs/queryvideo"
tags: ["file"]
---

# Query VHS video metadata

`GET /api/vhs/queryvideo`

VHS custom node endpoint that returns metadata about a video file
(frame count, fps, resolution, duration). Currently returns default
placeholder values; real ffprobe integration is a follow-up.

## Query parameters

- `filename` string, required

## Response `200`

Video metadata

- object
  - `source` object, required — Source video metadata
    - `duration` number, required — Duration in seconds
    - `fps` number, required — Frames per second
    - `frames` integer, required — Total frame count
    - `size` integer[], required — [width, height] in pixels

## Other responses

- `400` — Missing required query parameter. Produced by the oapi-codegen wrapper via echo.NewHTTPError; the custom Echo HTTPErrorHandler normalizes it to the standard ErrorResponse {code, message} shape (BE-1178).
- `401` — Unauthorized

---

[API](https://skmtc.net/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.net/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/9fb6092a836d/schema)