Agent API

TIG is built for AI agents and workflows.

Every tool is described in machine-readable files and callable over JSON — no HTML scraping. Free utilities need no key; AI tools use an API key and credits.

Quickstart

Every response uses the same envelope: { success, data, error: { code, message, docs_url }, credits: { charged, remaining }, timing_ms }

Compress a GIF — free, no key, instant
curl -X POST 'https://transparentimagegenerator.com/functions/agentApi?tool=compress-gif' \
  -H 'Content-Type: application/json' \
  -d '{"source_url":"https://example.com/input.gif","quality":60,"max_width":480}'
Convert PNG → JPG — free, no key
curl -X POST 'https://transparentimagegenerator.com/functions/agentApi?tool=convert/png-to-jpg' \
  -H 'Content-Type: application/json' \
  -d '{"source_url":"https://example.com/logo.png","quality":85}'
Generate a transparent PNG — AI job (3 credits)
curl -X POST 'https://transparentimagegenerator.com/functions/agentApi?tool=generator' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: tig_YOUR_KEY' \
  -d '{"prompt":"a cute cartoon fox mascot waving","style":"Sticker"}'

# → { "success": true, "data": { "job_id": "abc123", "status": "queued" }, ... }

curl 'https://transparentimagegenerator.com/functions/agentApi?job=abc123' -H 'X-Api-Key: tig_YOUR_KEY'
# → { "data": { "status": "completed", "progress_pct": 100, "result": { "output_url": "https://…png" } } }
How an agent discovers TIG
1. GET https://transparentimagegenerator.com/functions/agentApi?file=llms.txt        → overview + every tool URL
2. GET https://transparentimagegenerator.com/functions/agentApi?file=tools.json      → pick a tool by capability (e.g. "compress")
3. Read tools[i].input_schema      → build the JSON body
4. POST tools[i].api.endpoint      → sync: data.output_url | job: poll data.poll_url
5. If error.code == "BROWSER_ONLY" → send the user to data.action_url

Auth & credits

  • Free utilities (compress, resize, convert, frames → GIF, data URI, hex ↔ RGB): no key, no signup, instant.
  • AI tools (transparent generation, background removal): send X-Api-Key: tig_…. Credits are charged when the job is queued and refunded if it fails.
  • AI jobs return a job_id immediately. Poll ?job=<id> for status and progress_pct.
  • Tools marked “browser only” return an action URL that opens the tool pre-filled (e.g. ?prompt=).

Error codes

INVALID_PARAMS
— A parameter is missing, the wrong type, or out of range
UNSUPPORTED_FORMAT
— The input file type is not accepted by this tool
TOO_LARGE
— File over 15 MB (2 MB for data URIs)
INSUFFICIENT_CREDITS
— Not enough credits for this AI tool
RATE_LIMITED
— More than 30 free requests per minute
PROCESSING_FAILED
— The tool failed — AI credits are refunded automatically
AUTH_REQUIRED
— AI tool called without a valid API key
TOOL_NOT_FOUND / JOB_NOT_FOUND
— Unknown slug or job id
BROWSER_ONLY
— This tool runs in the browser only — open data.action_url

API keys

Keys spend your account credits on AI tools. Free tools don't need one.

All tools by category

179 tools. API = callable over JSON now; others open via action URL.

AI Studio

Background Removal

Convert

Enhance & Optimize

GIF & Animation

GIF Editor

GIF Remix & Effects

Image Generators

Landing Pages & Guides

Libraries & Galleries

Resources

Sprite Sheets

Utilities

Video

Workspace