AIMETADATASERVER API / V1READ A FILE ↓

FREE API / SERVER-SIDE

Read media files
from your own code.

Use one endpoint for image metadata and model layers, or audio/video container, stream and tag data. Results are returned as bounded JSON and are not stored.

SESSION KEY / 24 HOURS

Your free API key

Creating your session API key…

Expires: · 20 analyses · 500 MB total · one active request. A new key revokes the previous key from this browser session.

QUICK START

Upload one media file

curl -X POST https://aimetadata.online/api/v1/analyze \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "file=@asset.png"

The issued Bearer works in curl and backend code for 24 hours without sending the browser session cookie.

RESPONSE SCOPE

The layers depend on media type

  • Images: PNG text, EXIF, XMP, prompts, workflows and C2PA
  • Images: CPU visual estimate, content-risk estimate and COCO objects
  • Audio/video: format, duration, codecs, streams and bounded tags
  • Every response: model/parser versions, limitations and quota

LIVE TEST

Run one request here

The selected file is uploaded to a temporary private directory and deleted before the JSON response is returned. Nothing enters the public gallery.

CONTRACT / V1

Endpoint reference

POST /api/v1/session-keys
Same-origin key issuance. The session controls rotation; the Bearer remains usable externally until expiry.
POST /api/v1/analyze
Multipart field file, up to 100 MB on this domain, with Authorization: Bearer ….
Image response
Bounded text entries, generation settings, C2PA, visual estimate, content-risk estimate and object suggestions.
Audio/video response
ffprobe format, stream and tag data. The API does not claim AI detection for audio or video.
Privacy
No persistent upload, no key in logs, no result storage, and Cache-Control: no-store.

ERRORS / RETRIES

HTTP status contract

401
Bearer key is missing, invalid, expired or belongs to the other site.
413 / 415 / 422
File is too large, its media type is unsupported, or the multipart upload cannot be analyzed.
429 / 503
A quota, rate or concurrency limit was reached. Respect the Retry-After response header before retrying.
500
The analysis service failed. Retry later; do not assume anything about the file.