Get a key
Returns a user, a default app and an API key, shown once. Store it as AMPS_API_KEY.
Upload once. Serve anywhere. Transform by URL.
One API key, one folder, one URL grammar. An agent gets a trial key with a single call, uploads files, and ships CDN URLs that resize and convert on the fly. No account needed to start.
Image URL grammarGET · no API call
https://amps.media/users/U/apps/A/photos/cat.png/v1/fill/w_800,h_600,q_80/cat.webp
stored pathoperationparametersoutput name and format
1
curl -X POST https://api-test.amps.media/trial
2
Upload
The reply carries an upload_url; PUT the bytes there, then poll GET /uploads/{id} until the file lands.
curl -X POST https://api-test.amps.media/uploads \
-H "Authorization: Bearer $AMPS_API_KEY" \
-d '{"path":"photos/cat.png",
"mime_type":"image/png","size":204800}'3
Serve and transform
Public files need no call. Private files take a ?token= from GET /access/token.
https://amps.media/users/U/apps/A/photos/cat.png # resized, converted, cached at the edge …/apps/A/photos/cat.png/v1/fill/w_800,h_600/cat.webp
Quotas you can see
Every limit error says which meter ran out, how much you used and what lifts it. GET /usage returns the same numbers, so an agent stops at a 402 and tells the human exactly why.
Isolation by construction
Every file lives under /users/<U>/apps/<A>/. Keys and tokens are scoped to that folder, so one app can never list or read another.
For humans
Already have a trial key? Claim it with your e-mail to unlock private assets, more apps and upgrades. Have an account? Sign in.