https://fluxerusercontent.com.
See the Media Proxy API reference for the full list of available endpoints.
Field notation
Resource tables use a compact notation:| Notation | Meaning |
|---|---|
field | Required field |
field? | Optional field (may be omitted) |
?type | Nullable (value can be null) |
Enums
ImageSizeEnum
Allowed image sizes in pixels. Related endpointsGET /avatars/{id}/{filename}GET /icons/{id}/{filename}GET /banners/{id}/{filename}GET /emojis/{id}GET /stickers/{id}GET /attachments/{channel_id}/{attachment_id}/{filename}
| Value | Description |
|---|---|
16 | 16 pixels |
20 | 20 pixels |
22 | 22 pixels |
24 | 24 pixels |
28 | 28 pixels |
32 | 32 pixels |
40 | 40 pixels |
44 | 44 pixels |
48 | 48 pixels |
56 | 56 pixels |
60 | 60 pixels |
64 | 64 pixels |
80 | 80 pixels |
96 | 96 pixels |
100 | 100 pixels |
128 | 128 pixels |
160 | 160 pixels |
240 | 240 pixels |
256 | 256 pixels |
300 | 300 pixels |
320 | 320 pixels |
480 | 480 pixels |
512 | 512 pixels |
600 | 600 pixels |
640 | 640 pixels |
1024 | 1024 pixels |
1280 | 1280 pixels |
1536 | 1536 pixels |
2048 | 2048 pixels |
3072 | 3072 pixels |
4096 | 4096 pixels |
ImageFormatEnum
Allowed image output formats. Related endpoints| Value | Description |
|---|---|
png | PNG format |
jpg | JPEG format |
jpeg | JPEG format (alias) |
webp | WebP format (default, recommended) |
gif | GIF format (for animated images) |
ImageQualityEnum
Image quality levels. Related endpoints| Value | Description |
|---|---|
high | High quality compression, good balance of size and fidelity (default for most images) |
low | Lower quality for smaller file sizes, suitable for thumbnails |
lossless | No quality loss, largest file sizes (default for external media) |
Query parameter schemas
ImageQueryParams
Standard query parameters for image routes. Related endpoints| Field | Type | Description |
|---|---|---|
| size? | ImageSizeEnum | Target image size in pixels. Default: 128 |
| format? | ImageFormatEnum | Output image format. Default: webp |
| quality? | ImageQualityEnum | Image quality level. Default: high |
| animated? | boolean | Whether to return animated images (GIF, APNG) if available. Default: false |
ExternalMediaQueryParams
Query parameters for the external media proxy. Related endpoints| Field | Type | Description |
|---|---|---|
| width? | integer | Target width in pixels (1-4096). If only width is specified, height is calculated to maintain aspect ratio. |
| height? | integer | Target height in pixels (1-4096). If only height is specified, width is calculated to maintain aspect ratio. |
| format? | ImageFormatEnum | Output image format. If not specified, the original format is preserved. |
| quality? | ImageQualityEnum | Image quality level. Default: lossless |
| animated? | boolean | Whether to preserve animation for GIF images. Default: false |
Response schemas
MetadataResponse
Response from metadata extraction. Related endpoints| Field | Type | Description |
|---|---|---|
| format | string | Detected media format (e.g., png, jpeg, gif, mp4) |
| content_type | string | MIME content type |
| content_hash | string | SHA-256 hash of the content |
| size | integer | File size in bytes |
| width? | integer | Image or video width in pixels |
| height? | integer | Image or video height in pixels |
| duration? | number | Video or audio duration in seconds |
| placeholder? | string | BlurHash placeholder string for progressive loading |
| base64? | string | Base64-encoded content (if with_base64 was requested) |
| animated? | boolean | Whether the image is animated (GIF, APNG) |
| nsfw | boolean | Whether the content was flagged as NSFW |
| nsfw_probability? | number | NSFW probability score (0-1) |
| nsfw_predictions? | map<string, number> | Per-category NSFW predictions |
ThumbnailResponse
Response from thumbnail generation. Related endpoints| Field | Type | Description |
|---|---|---|
| thumbnail | string | Base64-encoded thumbnail image (JPEG) |
| mime_type | string | MIME type of the thumbnail (always image/jpeg) |
FrameResponse
Response from frame extraction. Related endpoints| Field | Type | Description |
|---|---|---|
| frames | ExtractedFrame[] | Extracted video frames |
ExtractedFrame
Single extracted video frame.| Field | Type | Description |
|---|---|---|
| timestamp | number | Frame timestamp in seconds |
| mime_type | string | MIME type of the frame image |
| base64 | string | Base64-encoded frame image |
Request schemas
MetadataRequest
Discriminated union for metadata extraction requests. Thetype field determines which variant is used.
Related endpoints
| Type | Description |
|---|---|
| MetadataRequestExternal | Fetch metadata from an external URL |
| MetadataRequestUpload | Get metadata from an uploaded file |
| MetadataRequestBase64 | Get metadata from base64-encoded data |
| MetadataRequestS3 | Get metadata from an S3 object |
MetadataRequestExternal
Metadata request for external URLs.| Field | Type | Description |
|---|---|---|
| type | string | Must be "external" |
| url | string | External URL to fetch |
| with_base64? | boolean | Include base64-encoded content in response |
| isNSFWAllowed | boolean | Whether NSFW content is permitted |
MetadataRequestUpload
Metadata request for uploaded files.| Field | Type | Description |
|---|---|---|
| type | string | Must be "upload" |
| upload_filename | string | Filename in the uploads bucket |
| isNSFWAllowed | boolean | Whether NSFW content is permitted |
MetadataRequestBase64
Metadata request for base64-encoded data.| Field | Type | Description |
|---|---|---|
| type | string | Must be "base64" |
| base64 | string | Base64-encoded media data |
| isNSFWAllowed | boolean | Whether NSFW content is permitted |
MetadataRequestS3
Metadata request for S3 objects.| Field | Type | Description |
|---|---|---|
| type | string | Must be "s3" |
| bucket | string | S3 bucket name |
| key | string | S3 object key |
| with_base64? | boolean | Include base64-encoded content in response |
| isNSFWAllowed | boolean | Whether NSFW content is permitted |
FrameRequest
Discriminated union for frame extraction requests. Thetype field determines which variant is used.
Related endpoints
| Type | Description |
|---|---|
| FrameRequestUpload | Extract frames from an uploaded file |
| FrameRequestS3 | Extract frames from an S3 object |
FrameRequestUpload
Frame extraction request for uploaded files.| Field | Type | Description |
|---|---|---|
| type | string | Must be "upload" |
| upload_filename | string | Filename in the uploads bucket |
FrameRequestS3
Frame extraction request for S3 objects.| Field | Type | Description |
|---|---|---|
| type | string | Must be "s3" |
| bucket | string | S3 bucket name |
| key | string | S3 object key |
ThumbnailRequestBody
Request body for thumbnail generation. Related endpoints| Field | Type | Description |
|---|---|---|
| upload_filename | string | Filename of the uploaded video in the uploads bucket |