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
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, withAuthorization: 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-Afterresponse header before retrying. - 500
- The analysis service failed. Retry later; do not assume anything about the file.