feat: add unified media inspection endpoint

app/api/media.py

@@ -27,6 +27,20 @@ async def execute_operation(request: Request, name: str, operation: Operation) -
     return await processor.run(resolved, name, operation)
 
 
+@router.post("/v1/media/inspect", response_model=SuccessResponse, name="inspect_media")
+async def inspect_media(request: Request) -> SuccessResponse:
+    """Inspect uploaded or remotely referenced media without transforming it.
+
+    Accepts the same multipart, JSON URL/Base64, n8n binary, and raw-body
+    inputs as processing endpoints. The shared resolver and FFprobe validation
+    keep this endpoint's behavior consistent with the processing pipeline.
+    """
+    request.state.operation = "media.inspect"
+    processor = get_processor(request)
+    resolved = await processor.resolver.resolve(request)
+    return await processor.probe(resolved)
+
+
 async def stream_file(path: Path) -> AsyncIterator[bytes]:
     async with aiofiles.open(path, "rb") as media:
         while chunk := await media.read(1024 * 1024):