Skip to main content

​
Endpoint

GET https://api.ugc.inc/media/file/[...path]
GET https://api.ugc.inc/media/file/{id}
GET https://api.ugc.inc/media/file/{id}/preview
GET https://api.ugc.inc/media/file/{id}/audio

​
Overview

Public file endpoint used by returned media URLs. No authentication is required.
  • /media/file/{id}: main file for user_media; audio file for social_audio
  • /media/file/{id}/preview: preview image when available
  • /media/file/{id}/audio: explicit audio path for social_audio

​
Path Parameters

​
id
string
required
Media ID.
​
subpath
'preview' | 'audio'
Optional file variant.

​
Response

Binary stream with appropriate Content-Type. The endpoint forwards HTTP range requests and returns 206 Partial Content when a Range header is provided. Common headers:
  • Accept-Ranges: bytes
  • Cache-Control: public, max-age=31536000, immutable

​
Example

curl -H "Range: bytes=0-1023" "https://api.ugc.inc/media/file/media_123" -o chunk.bin