Execute (TOOLGRID API GATEWAY)

POST /v1/execute · multipart/form-data · Try in testing console

Required

• Header Authorization: Bearer tg_api_…
• Header Idempotency-Key (unique per logical request; replays return the stored response without re-charging)
• Field tool — stable tool ID
• Field file — binary upload

Tool-specific fields

Additional multipart fields map to each tool's parameters (see tool reference pages). Unknown or invalid parameters return validation errors before credits are reserved. Use the testing console to search a tool, pick fields, and copy the multipart JSON.

Success envelope

{
  "success": true,
  "request_id": "…",
  "tool": "background_removal",
  "tool_version": "1",
  "result": { },
  "billing": {
    "api_credits_charged": 80,
    "usd_equivalent": "0.0080",
    "usd_cents": 0.8,
    "balance_remaining": 199920,
    "pricing_version": "2"
  }
}

Discover tools

GET /v1/tools (API key required) or the public catalog used by this documentation site.

Multiple files?

For async multi-file processing, use Batch jobs (POST /v1/jobs) when batch.supported is true on the tool catalog.