For AI Agents

This page provides machine-readable information about the Tools.FAST API network for AI agents, coding assistants, and automated systems.

What is Tools.FAST?

Tools.FAST is a network of file-processing APIs. Each tool handles one category of file operations. All tools share the same API key, credit wallet, and authentication model.

Available tools

Base URL: https://api.tools.fast

Authentication

All requests use the X-Fast-Api-Key header:

X-Fast-Api-Key: fast_prod_your_key_here

Get a key at https://accounts.tools.fast/account/login under API Keys.

Common workflow: submit, poll, download

Every tool follows the same 3-step async pattern:

Bash

# 1. Submit a file -- returns a job ID
JOB_ID=$(curl -sS -X POST "https://api.tools.fast/convert" \
  -H "X-Fast-Api-Key: $API_KEY" \
  -F "file=@input.heic" \
  -F "targetFormat=jpg" | jq -r '.id')

# 2. Poll until status is "Succeeded", "Failed", or "Canceled"
while true; do
  RESPONSE=$(curl -sS "https://api.tools.fast/convert/job/${JOB_ID}" \
    -H "X-Fast-Api-Key: $API_KEY")
  STATUS=$(echo "$RESPONSE" | jq -r '.status')
  [ "$STATUS" = "Succeeded" ] && break
  [ "$STATUS" = "Failed" ] || [ "$STATUS" = "Canceled" ] && exit 1
  sleep 1
done

# 3. Download the result (output.fileName has the correct filename)
FILENAME=$(echo "$RESPONSE" | jq -r '.output.fileName')
curl -sS "https://api.tools.fast/convert/job/${JOB_ID}/download" \
  -H "X-Fast-Api-Key: $API_KEY" -o "./${FILENAME}"

PowerShell

# 1. Submit a file -- returns a job ID
$job = Invoke-RestMethod -Method Post "https://api.tools.fast/convert" `
  -Headers @{ "X-Fast-Api-Key" = $env:API_KEY } `
  -Form @{ file = Get-Item "input.heic"; targetFormat = "jpg" }

# 2. Poll until status is "Succeeded", "Failed", or "Canceled"
do {
  $status = Invoke-RestMethod "https://api.tools.fast/convert/job/$($job.id)" `
    -Headers @{ "X-Fast-Api-Key" = $env:API_KEY }
  if ($status.status -in "Failed", "Canceled") { throw "Job $($job.id) $($status.status)" }
  Start-Sleep -Seconds 1
} while ($status.status -ne "Succeeded")

# 3. Download the result (output.fileName has the correct filename)
Invoke-RestMethod "https://api.tools.fast/convert/job/$($job.id)/download" `
  -Headers @{ "X-Fast-Api-Key" = $env:API_KEY } -OutFile "./$($status.output.fileName)"

Job status values

Convert.FAST quick reference

Endpoints

CLI wrapper

Convert.FAST provides wrapper scripts that handle submit + poll + download in one command:

Bash

curl -fsSL https://convert.fast/convert.fast.sh -o convert.fast.sh && chmod +x convert.fast.sh
export TOOLS_FAST_API_KEY="fast_prod_your_key_here"

./convert.fast.sh photo.heic jpg              # basic conversion
./convert.fast.sh document.pdf docx            # PDF to Word
./convert.fast.sh scan.pdf docx out.docx '{"ocr":{"enabled":true}}'  # with options

PowerShell

Invoke-RestMethod "https://convert.fast/convert.fast.ps1" -OutFile convert.fast.ps1
$env:TOOLS_FAST_API_KEY = "fast_prod_your_key_here"

./convert.fast.ps1 photo.heic jpg              # basic conversion
./convert.fast.ps1 document.pdf docx            # PDF to Word
./convert.fast.ps1 scan.pdf docx out.docx '{"ocr":{"enabled":true}}'  # with options

Skill file for AI agents

For a comprehensive guide designed specifically for AI agents, download the Convert.FAST skill file:

Bash

curl -fsSL https://convert.fast/SKILL.md -o SKILL.md
curl -fsSL https://convert.fast/api/docs.md -o reference/docs.md
curl -fsSL https://convert.fast/convert.fast.sh -o convert.fast.sh && chmod +x convert.fast.sh

PowerShell

Invoke-RestMethod "https://convert.fast/SKILL.md" -OutFile SKILL.md
Invoke-RestMethod "https://convert.fast/api/docs.md" -OutFile reference/docs.md
Invoke-RestMethod "https://convert.fast/convert.fast.ps1" -OutFile convert.fast.ps1

SKILL.md contains setup instructions, API flow, discovery, options, and error handling -- everything an AI agent needs to use Convert.FAST autonomously.

Compress.FAST quick reference

Endpoints

Error handling

All errors return JSON with error and detail fields:

{
  "error": "entitlements.insufficient_credits",
  "detail": "Insufficient credits. Required: 5, Available: 2"
}

Key error codes:

Credit costs

Most operations cost 1 credit. Multi-page documents cost 1 credit per page. Check specific costs with the estimation endpoint or each tool's documentation.

Tier limits