Authentication
Create a key on Agents and send it as Authorization: Bearer sm_live_…. Keys act as you, with your plan’s limits. Revoke a key at any time.
curl -X POST https://supermedia.space/api/v1/ai/jobs \
-H "Authorization: Bearer $SUPERMEDIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"capabilityId":"image.upscale.v1","imageUrl":"https://example.com/photo.jpg","wait":45}'MCP server
Streamable HTTP at https://supermedia.space/api/mcp. Stateless; send your key in the Authorization header.
| Tool | What it does |
|---|---|
| list_capabilities | What this server can do: API operations, AI tools with daily limits, and browser-only tools with links. |
| get_credits | Feature allowances, used, reserved, remaining, and monthly reset; legacy credits for existing purchases. |
| list_files | List files in the user's Drive, newest first, with storage usage. |
| get_file | File details plus a download URL valid for 10 minutes. |
| import_file | Download a public https URL (up to 100 MB) into the user's Drive. |
| delete_file | Permanently delete a Drive file and its share link. |
| share_file | Create a public link to a Drive file. Videos, images, audio, and PDFs play in the browser. |
| unshare_file | Turn off a file's public link. |
| edit_image | Resize, compress, convert, crop to an aspect ratio, rotate, strip metadata, or watermark an image. The result is saved to Drive. Params by operation — resize: width, height, percent, fit (inside|cover|fill); compress: quality 1-100, format; convert: format (jpeg|png|webp); crop: aspectRatio like "9:16", position; rotate: degrees (90|180|270), flipHorizontal, flipVertical; watermark: text, position, sizePercent, opacityPercent. |
| upscale_image | AI super-resolution to about 2 megapixels (PiSA-SR). Counts toward the daily AI allowance. |
| remove_background | AI background removal; returns a transparent PNG (BiRefNet). Counts toward the daily AI allowance. |
| transcribe_media | Speech to text with timestamps from a Drive video/audio file or a public media URL. Check account usage for current duration and monthly allowances. |
| tiktok_transcript | Transcript with timestamps for a public TikTok video link. |
| get_job | State and result of an AI job. |
| save_result_to_drive | Keep an AI image result in Drive (results otherwise expire after 24 hours). |
REST
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/capabilities | Everything the API and agents can do. No key needed. |
| GET | /api/v1/files | List Drive files and storage usage. |
| POST | /api/v1/files | JSON {url, name?} imports a public URL (≤ 100 MB). Any other body is stored as the file (≤ 4 MB, ?name=). |
| GET | /api/v1/files/{id} | File details and a 10-minute download URL. |
| GET | /api/v1/files/{id}/content | File bytes (range requests supported). |
| POST | /api/v1/files/{id}/share | Public link. Body {expiresInDays?}. |
| DELETE | /api/v1/files/{id}/share | Turn the link off. |
| DELETE | /api/v1/files/{id} | Delete permanently. |
| POST | /api/v1/images/edit | {fileId | imageUrl, operation, params} → new Drive file. |
| POST | /api/v1/ai/jobs | {capabilityId, fileId | imageUrl | url, wait?} starts an AI job. |
| GET | /api/v1/ai/jobs/{id}?wait=30 | Job state and result. |
| POST | /api/v1/ai/jobs/{id}/save | Keep an AI image result in Drive. |
Limits and retention
API and MCP use the same feature allowances as the website and extensions. AI results are erased after 24 hours unless saved to Drive. Drive files stay until you delete them; Storage and file limits are listed on Pricing. Errors return { "error": "code", "correlationId" }. Social publishing and the video editor are coming soon.