Resolve a public asset link to embed-player file paths
Returns the HLS streaming manifest keyPath and a fallback original-media keyPath for the asset behind a public download token. Used by the in-iframe embeddable player at /public/{token}/embed. The frontend resolves keyPaths against `VITE_NURAMA_FILE_BASEPATH` and uses HLS.js to play the `.m3u8` manifest when `streamKeyPath` is present, falling back to the original media file otherwise. `video`, `audio`, `3d` and `document` assets embed: a 3D asset plays its processed `media` model (`mediaKeyPath`), and a document fetches its viewer PDF from `/public-download/{token}/document-view`. Other media types return paths for completeness but aren't embedded. No authentication required. Returns minimal file info — never the full asset record (no `id`, `files`, `creatorId`, etc.).
Returns the HLS streaming manifest keyPath and a fallback original-media keyPath for the asset behind a public download token. Used by the in-iframe embeddable player at /public/{token}/embed.
The frontend resolves keyPaths against VITE_NURAMA_FILE_BASEPATH and uses
HLS.js to play the .m3u8 manifest when streamKeyPath is present, falling
back to the original media file otherwise. video, audio, 3d and document
assets embed: a 3D asset plays its processed media model (mediaKeyPath), and a
document fetches its viewer PDF from /public-download/{token}/document-view.
Other media types return paths for completeness but aren't embedded.
No authentication required. Returns minimal file info — never the full asset
record (no id, files, creatorId, etc.).
Path Parameters
The 10-character alphanumeric public download token.
^[a-zA-Z0-9]{10}$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public-download/Ab3dEf9HiJ/embed-files"{ "fileName": "my-video.mp4", "mediaType": "video", "mode": "embed-download", "streamKeyPath": "/workspaces/abc/assets/123/stream/index.m3u8", "mediaKeyPath": "/workspaces/abc/assets/123/media/my-video.mp4", "posterKeyPath": "/workspaces/abc/assets/123/customThumbnail/large.jpg?v=019e10aa-0000-7000-8000-000000000002", "waveformKeyPath": "/workspaces/abc/assets/123/waveform/peaks.json", "storyboard": {}, "storyboardFiles": [ { "name": "string", "keyPath": "string" } ]}