Skip to main content
POST
/
_metadata
Extract media metadata
curl --request POST \
  --url https://fluxerusercontent.com/_metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "url": "<string>",
  "isNSFWAllowed": true,
  "with_base64": true
}
'
{
  "format": "<string>",
  "content_type": "<string>",
  "content_hash": "<string>",
  "size": 123,
  "nsfw": true,
  "width": 123,
  "height": 123,
  "duration": 123,
  "placeholder": "<string>",
  "base64": "<string>",
  "animated": true,
  "nsfw_probability": 123,
  "nsfw_predictions": {}
}

Authorizations

Authorization
string
header
required

Internal service authentication using Bearer token

Body

application/json

Metadata request for external URLs

type
string
required
Allowed value: "external"
url
string<uri>
required

External URL to fetch

isNSFWAllowed
boolean
required

Whether NSFW content is permitted

with_base64
boolean

Include base64-encoded content in response

Response

Metadata extracted successfully

Response from metadata extraction

format
string
required

Detected media format (e.g., png, jpeg, gif, mp4)

content_type
string
required

MIME content type

content_hash
string
required

SHA-256 hash of content

size
integer
required

File size in bytes

nsfw
boolean
required

NSFW detection result

width
integer

Image/video width in pixels

height
integer

Image/video height in pixels

duration
number

Video/audio duration in seconds

placeholder
string

BlurHash placeholder string

base64
string

Base64-encoded content (if requested)

animated
boolean

Whether the media is animated

nsfw_probability
number

NSFW probability score (0-1)

nsfw_predictions
object

Per-category NSFW predictions