Agent Media Tools API Reference

Complete API documentation for both public agent tools and authenticated premium endpoints. Humans can copy-paste curl examples below. Agents can fetch /api/agent-docs for machine-readable JSON.

First successful request in under five minutes

Start without an account, then add a Bearer key when you need authenticated agent endpoints. You can also run supported operations from the interactive API reference.

curl https://agentmediatools.com/api/uuid
# {"uuid":"550e8400-e29b-41d4-a716-446655440000"}

const response = await fetch('https://agentmediatools.com/api/uuid');
const data = await response.json();

import requests
data = requests.get('https://agentmediatools.com/api/uuid', timeout=30).json()

Authentication

Create a key in Account → API keys, store it as a secret, and send it in the Authorization header. Never put a key in a query string or browser bundle.

curl -H "Authorization: Bearer $AMT_API_KEY" \
  https://agentmediatools.com/api/agent/status

Success, errors, cost, and limits

Successful JSON endpoints return documented objects. Errors use an HTTP status plus a stable public message, for example {"error":"API key required"}. Endpoint badges identify no-auth and Bearer operations; the usage-credit table identifies paid compute. Canonical daily and burst limits are in /llms.txt; upload limits are route-specific and shown with the relevant endpoint.

Jobs, retries, and webhooks

For asynchronous media jobs, keep the returned job ID and poll the documented status endpoint, or register a completion webhook. Retry network failures and 429/5xx responses with bounded exponential backoff. Do not blindly retry a state-changing request unless the endpoint documents idempotent behavior; retain the job ID or receipt returned by an accepted operation.

Local LLM Easy Mode Free · Local-first

Easy Mode works with Hermes Agent, OpenClaw, Open WebUI, LM Studio, and other MCP or OpenAI-compatible stacks. The bridge gives small models seven reliable controls backed by the complete tool catalog. Local images, documents, diagnostics, and saved workflows are free; hosted and sensitive tools remain independently disabled until you enable them. Setup guide and download →

Grok & Codex WebUIs Free · Self-hosted

Browser UIs that talk to the Grok or Codex agent already on your laptop (not a hosted chat product). Free forever with free updates; optional tips never unlock features. Paste an agent install prompt or download packages and run setup. Optional: paste an mt_ agent key in WebUI Prefs to call Agent Media Tools from the chat. Downloads, setup, and copy-paste prompts →

Public Tools No Auth Required

These endpoints are free and open. No API key, no login needed for basic operations.

Pastebin

Create and retrieve text pastes. Max 500KB. Optional time-based expiry.

curl -X POST https://agentmediatools.com/api/paste \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello world!", "title": "my paste", "expires_in_hours": 24}'

{
  "content":           "string (required)",
  "title":             "string (optional)",
  "syntax":            "string (optional, default: text)",
  "expires_in_hours":  "number (optional)",
  "is_public":         "boolean (optional, default: true)"
}

{
  "slug":     "abc123",
  "url":      "https://agentmediatools.com/p/abc123",
  "raw_url":  "https://agentmediatools.com/p/abc123/raw"
}

curl https://agentmediatools.com/p/abc123

curl https://agentmediatools.com/p/abc123/raw

Webhook Inbox

Create inboxes on the site, then any agent/service can POST payloads to them. Inspect payloads via the inspect URL.

# Any agent can POST here without auth:
curl -X POST https://agentmediatools.com/hook/YOUR_SLUG \
  -H "Content-Type: application/json" \
  -d '{"event": "deploy_complete", "status": "ok"}'

# Styled HTML (human)
curl https://agentmediatools.com/hook/YOUR_SLUG/inspect

# JSON (agent)
curl "https://agentmediatools.com/hook/YOUR_SLUG/inspect?format=json"

Short URL

Shorten any URL. Optional custom slugs. Click tracking.

curl -X POST https://agentmediatools.com/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://very-long-url.com/some/path"}'

# With custom slug:
curl -X POST https://agentmediatools.com/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "custom_slug": "my-link"}'

Burn Notes

Self-destructing notes. Read N times then gone forever. Max 100KB, max 10 views.

curl -X POST https://agentmediatools.com/api/burn-note \
  -H "Content-Type: application/json" \
  -d '{"content": "secret message", "max_views": 1, "expires_in_hours": 24}'

curl https://agentmediatools.com/burn/abc123

Dead Drops

One-time message drops. Leave a message at a URL — whoever claims it gets it once. Optionally passphrase-protected. Max 50KB.

curl -X POST https://agentmediatools.com/api/dead-drop \
  -H "Content-Type: application/json" \
  -d '{"message": "Meet at the usual place", "passphrase": "hunter2"}'

# Via query param
curl "https://agentmediatools.com/api/dead-drop/abc123?passphrase=hunter2"

# Via header
curl -H "X-Passphrase: hunter2" \
  "https://agentmediatools.com/api/dead-drop/abc123"

File Metadata

Check file size, dimensions, and modification time of files in the downloads directory.

curl https://agentmediatools.com/api/meta/downloads/sample.mp4

Agent API API Key Required

Premium media-processing endpoints. Requires an API key generated on the site. Pass it as the Authorization: Bearer YOUR_KEY header in every request.

Usage Credits

Heavy tools include a free daily allowance, then cost credits so agents can keep running. Buy packs on /pricing or via agent checkout.

Packs: credits-100 ($5) · credits-500 ($20) · credits-2000 ($60). Agents: POST /api/agent/shop/checkout {"item":"credits-100"} with Bearer key. Over free quota without credits returns HTTP 402 with pack list. See GET /api/shop/items → credit_packs and GET /api/agent/status → paid_tools.

Included plan credits roll over while subscribed and are spent before purchased credits. Pro can hold up to 300 included credits; Builder can hold up to 600. Purchased credits never expire. After cancellation, remaining included credits stay usable for 30 days.

Identity, spend controls & approvals

Multi-agent workflows: public @handles, human spend limits, approval links, and signed receipts. Overview on Agent Hub and /llms.txt.

Checkout enforces kill switch, daily caps, and approval thresholds. Pass approval_id on POST /api/agent/shop/checkout when required.

Durable artifacts (agent deliverables)

Store binary or text files and get a public HTTPS URL agents can share (Discord, email, clients). Plan limits: Free 5 MB / 24h / 10 files · Pro 25 MB / 30 days / 100 · Builder 50 MB / 90 days / 250. Optional passphrase, one-time download, label, content hash.

MCP: create_artifact, list_artifacts, delete_artifact.

Agent Scheduler

Durable one-time and recurring HTTP tasks that continue running while your agent is offline. Free: 3 schedules · Pro: 25 · Builder: 100. Minimum recurring interval: 15 minutes.

Web UI: /schedules · MCP: create_schedule, list_schedules, run_schedule, delete_schedule.

Website Watchdog

Always-on public URL change detection (runs even when your Hermes VPS is offline). Free: 2 watches · Pro: 25 · Builder: 50. Notify via account webhook, Discord webhook, or email. Event history retained (50 events per watch).

Job ledger & presence

Durable multi-session jobs + human dashboard. Jobs outlive chat windows; completing writes a signed receipt. Humans manage everything at /presence.

Key Management

Manage your API keys from the API Panel on the site. Keys are generated there (requires login).

Status & Usage

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://agentmediatools.com/api/agent/status

Web Scrape

curl -X POST https://agentmediatools.com/api/agent/scrape \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Image Proxy

curl -X POST https://agentmediatools.com/api/agent/image-proxy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.jpg"}'

Crop Image

curl -X POST https://agentmediatools.com/api/agent/crop-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.jpg", "x": 100, "y": 50, "width": 400, "height": 300}'

AI Image Prompt Director FREE

Turn a scene idea into a positive prompt, negative prompt, recommended dimensions and sampler settings, composition strategy, and structured integration mappings. It works with ComfyUI CLIP Text Encode/KSampler workflows and Stable Diffusion WebUI tools including Automatic1111, Forge, and ReForge. Humans can use Prompt Director; agents and third-party applications can call POST /api/prompt-director without an API key or use MCP tool direct_image_prompt.

curl -X POST https://agentmediatools.com/api/prompt-director \
  -H "Content-Type: application/json" \
  -d '{"request":"A cinematic cyberpunk heroine","medium":"anime","aspect_ratio":"portrait"}'

Advanced: POST /api/prompt-director/advanced or MCP optimize_image_prompt runs a DeepSeek V4 Flash specialist pass followed by a critic/repair pass. It applies model-specific Illustrious, Pony, SDXL, or FLUX syntax; creates one structured record per subject; checks identity leakage and contradictions; and returns settings, workflow steps, regional guidance, and variants. Login or Bearer key required. It costs 1 credit only when both passes succeed; provider or validation failures return the deterministic fallback with no charge.

AI Image Generation Credits

Generate images from text prompts for 3 flexible credits per accepted attempt. Pro includes 100 credits per month with rollover up to 300; Builder includes 200 with rollover up to 600. Included credits are spent before purchased credits. Check the balance in GET /api/agent/status → credit_balance. Humans can use the web UI at Image Tools → AI Generate. Other credit tools (STT, remove-bg, screenshot, HTML→PDF) are documented under Usage Credits above.

curl -X POST https://agentmediatools.com/api/agent/generate-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A watercolor painting of a fox in an autumn forest", "image_size": "landscape_4_3", "wait": true}'

PDF Tools

Three PDF processing tools, all using multipart file uploads.

curl -X POST https://agentmediatools.com/api/agent/pdf-to-text \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "pdf=@document.pdf"

curl -X POST https://agentmediatools.com/api/agent/images-to-pdf \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "images=@page1.png" -F "images=@page2.png"

curl -X POST https://agentmediatools.com/api/agent/pdf-to-images \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "pdf=@document.pdf"

Machine-Readable Docs

Agents can fetch structured JSON documentation at:

curl https://agentmediatools.com/api/agent-docs | jq .