API documentation

Read format, dimensions, color space and size

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. No extra fields required — upload only.
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/info \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.jpg"

{
  "format": "jpeg",
  "width": 4032,
  "height": 3024,
  "space": "srgb",
  "channels": 3,
  "depth": "uchar",
  "density": 72,
  "has_alpha": false,
  "orientation": 1,
  "size_bytes": 2456789,
  "request_id": "req_…",
  "credits_used": 1,
  "credits_remaining": 99
}

Resize with fit modes; optional output format

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. Set width and/or height (1–10000). Optional: fit (cover|contain|fill|inside|outside), format, quality, enlarge.
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/resize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  -F "width=1024" \
  -F "height=768" \
  -F "fit=inside" \
  -F "format=webp" \
  -F "quality=82" \
  --output resized.webp

HTTP 200
Content-Type: image/webp
Content-Disposition: inline; filename="resized.webp"
X-Request-Id: req_…
X-FatBaby-Credits-Used: …
X-FatBaby-Credits-Remaining: …

<body = binary image bytes>

# Dashboard logs store metadata only, e.g.:
{
  "kind": "image",
  "content_type": "image/webp",
  "filename": "resized.webp",
  "size_bytes": 184320,
  "credits_used": 2,
  "credits_remaining": 98,
  "note": "Binary image output is not stored in logs; metadata only."
}

Re-encode with quality controls

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. Optional: format, quality (1–100, default 80).
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/compress \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  -F "format=jpeg" \
  -F "quality=80" \
  --output compressed.jpg

HTTP 200
Content-Type: image/jpeg
Content-Disposition: inline; filename="compressed.jpg"
X-Request-Id: req_…
X-FatBaby-Credits-Used: …
X-FatBaby-Credits-Remaining: …

<body = binary image bytes>

# Dashboard logs store metadata only, e.g.:
{
  "kind": "image",
  "content_type": "image/jpeg",
  "filename": "compressed.jpg",
  "size_bytes": 184320,
  "credits_used": 2,
  "credits_remaining": 98,
  "note": "Binary image output is not stored in logs; metadata only."
}

Convert between JPEG, PNG, WebP, AVIF

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. Required: format (jpeg|png|webp|avif). Optional: quality.
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/convert \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=82" \
  --output converted.webp

HTTP 200
Content-Type: image/webp
Content-Disposition: inline; filename="converted.webp"
X-Request-Id: req_…
X-FatBaby-Credits-Used: …
X-FatBaby-Credits-Remaining: …

<body = binary image bytes>

# Dashboard logs store metadata only, e.g.:
{
  "kind": "image",
  "content_type": "image/webp",
  "filename": "converted.webp",
  "size_bytes": 184320,
  "credits_used": 2,
  "credits_remaining": 98,
  "note": "Binary image output is not stored in logs; metadata only."
}

Attention-cropped square/rect thumbnails

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. Optional: width/height (default 320), format (default webp), quality.
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/thumbnail \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  -F "width=320" \
  -F "height=320" \
  -F "format=webp" \
  -F "quality=80" \
  --output thumb.webp

HTTP 200
Content-Type: image/webp
Content-Disposition: inline; filename="thumbnail.webp"
X-Request-Id: req_…
X-FatBaby-Credits-Used: …
X-FatBaby-Credits-Remaining: …

<body = binary image bytes>

# Dashboard logs store metadata only, e.g.:
{
  "kind": "image",
  "content_type": "image/webp",
  "filename": "thumbnail.webp",
  "size_bytes": 184320,
  "credits_used": 2,
  "credits_remaining": 98,
  "note": "Binary image output is not stored in logs; metadata only."
}

Remove EXIF/IPTC/XMP by re-encoding

1. Create an API key in the dashboard and copy the fb_live_… (or fb_test_…) secret.
2. Send Authorization: Bearer <key> on every request to https://thefatbaby.com/api.
3. POST multipart/form-data with field name file (max 20 MB; JPEG/PNG/WebP/AVIF/GIF).
4. No extra fields — upload only; response is a re-encoded image without metadata.
5. For transform endpoints, save the binary response body (--output). Image info returns JSON.
6. Read X-FatBaby-Credits-Used and X-FatBaby-Credits-Remaining (or JSON credit fields).

curl -X POST https://thefatbaby.com/api/v1/image/strip-metadata \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  --output clean.jpg

HTTP 200
Content-Type: image/jpeg
Content-Disposition: inline; filename="clean.jpg"
X-Request-Id: req_…
X-FatBaby-Credits-Used: …
X-FatBaby-Credits-Remaining: …

<body = binary image bytes>

# Dashboard logs store metadata only, e.g.:
{
  "kind": "image",
  "content_type": "image/jpeg",
  "filename": "clean.jpg",
  "size_bytes": 184320,
  "credits_used": 2,
  "credits_remaining": 98,
  "note": "Binary image output is not stored in logs; metadata only."
}

List supported media operations, limits, presets and credit rates

1. Create an API key in the dashboard.
2. GET /v1/capabilities with Authorization: Bearer <key> (no body).
3. Use sync_operations / async_operations, presets, and credits maps to drive your client UI.
4. This call is free (0 credits) and does not create a job.

curl https://thefatbaby.com/api/v1/capabilities \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "version": "1.0",
  "sync_operations": ["media.inspect", "media.validate"],
  "async_operations": ["video.convert", "video.compress", "…"],
  "compress_presets": ["low", "medium", "high", "archive"],
  "credits": { "video.convert": 5, "media.inspect": 1 }
}

Sync ffprobe summary (format, streams, duration, dimensions)

1. Create an API key and confirm at least 1 credit.
2. POST multipart file (or url) to /v1/media/inspect with Authorization: Bearer <key>.
3. Read the JSON media summary (format, duration, streams). This is sync — no job polling.
4. Credits are deducted immediately on success.

curl -X POST https://thefatbaby.com/api/v1/media/inspect \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4"

{
  "success": true,
  "media": {
    "format": "mov,mp4,m4a,3gp,3g2,mj2",
    "duration_sec": 12.4,
    "width": 1920,
    "height": 1080,
    "video_streams": [{ "codec": "h264", "width": 1920, "height": 1080 }],
    "audio_streams": [{ "codec": "aac", "channels": 2 }]
  },
  "request_id": "req_…",
  "credits_used": 1
}

Sync check against duration, dimension and size limits before processing

1. Create an API key.
2. POST multipart file (or url) to /v1/media/validate.
3. Check valid and any errors[] against platform limits before submitting a heavy async job.
4. Sync response — no job id. 1 credit on success.

curl -X POST https://thefatbaby.com/api/v1/media/validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4"

{
  "success": true,
  "valid": true,
  "errors": [],
  "media": { "duration_sec": 12.4, "width": 1920, "height": 1080 },
  "request_id": "req_…",
  "credits_used": 1
}

Async convert to allowlisted container/codec. Poll GET /v1/jobs/:id

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set format (e.g. mp4) and optional video_codec (e.g. libx264).
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/convert \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mov" \
  -F "format=mp4" \
  -F "video_codec=libx264"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.convert",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 5
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async compress with presets: low | medium | high | archive

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set preset to low, medium, high, or archive.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/compress \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "preset=medium"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.compress",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 5
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async scale video to target width/height

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set width and/or height. Optional fit/scale options per capabilities.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/resize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "width=1280" \
  -F "height=720"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.resize",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 4
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async crop to a rectangular region

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Provide crop region fields (width, height, x, y) as documented in capabilities.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/crop \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "width=1080" \
  -F "height=1080" \
  -F "x=420" \
  -F "y=0"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.crop",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 4
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async trim by start + duration/end (seconds or HH:MM:SS)

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set start and duration (or end). Values may be seconds or HH:MM:SS.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/trim \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "start=00:00:05" \
  -F "duration=10"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.trim",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 3
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async concatenate multiple inputs into one file

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Upload multiple files via multipart field files (or repeated file uploads) in the desired order.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/merge \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "files=@part1.mp4" \
  -F "files=@part2.mp4"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.merge",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 6
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async extract a still frame as an image

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Optional: time/timestamp for the frame, output format/size.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/thumbnail \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "time=00:00:02"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.thumbnail",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 2
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async overlay an image watermark on video

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Upload video as file and watermark image as a second multipart file (e.g. watermark). Optional position/opacity.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/watermark \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "watermark=@logo.png" \
  -F "position=bottom-right"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.watermark",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 5
  },
  "request_id": "req_…",
  "credits_used": 0
}

List your async media jobs with optional status filter

1. Authenticate with Authorization: Bearer <key>.
2. GET /v1/jobs?limit=20&offset=0 (optional status=queued|processing|completed|failed|cancelled).
3. Iterate jobs[] to build a dashboard or resume polling for in-flight work.
4. Free (0 credits).

curl "https://thefatbaby.com/api/v1/jobs?limit=20" \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "success": true,
  "jobs": [
    { "id": "…", "operation": "video.convert", "status": "completed", "progress": 100 }
  ]
}

Poll async media job status, progress and signed download URLs

1. After submitting an async op, note job.id from the create response.
2. GET /v1/jobs/:jobId with your API key every few seconds while status is queued or processing.
3. When status is completed, use job.output.downloads[].url or the download endpoint.
4. Free (0 credits).

curl https://thefatbaby.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "success": true,
  "job": {
    "id": "JOB_ID",
    "status": "completed",
    "progress": 100,
    "output": {
      "primary": "converted.mp4",
      "files": ["converted.mp4"],
      "downloads": [{ "filename": "converted.mp4", "url": "https://…/v1/jobs/JOB_ID/download?…" }]
    }
  }
}

Download an output file (API key or signed token query)

1. Ensure the job status is completed and note the output filename.
2. GET /v1/jobs/:jobId/download?filename=out.mp4 with Authorization, or use the signed token URL from the job payload.
3. Without filename, the API returns a JSON list of available files and URLs.
4. Save the binary body with curl --output. Free (0 credits).

curl "https://thefatbaby.com/api/v1/jobs/JOB_ID/download?filename=converted.mp4" \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  --output converted.mp4

HTTP 200
Content-Type: video/mp4
Content-Disposition: attachment; filename="converted.mp4"

<body = binary file bytes>

# Or without filename:
{
  "success": true,
  "job_id": "JOB_ID",
  "files": [{ "filename": "converted.mp4", "url": "https://…" }]
}

Cancel a queued or processing job and release reserved credits

1. Identify a job that is still queued or processing.
2. POST /v1/jobs/:jobId/cancel with Authorization: Bearer <key>.
3. Confirm status becomes cancelled; reserved credits are released.
4. Jobs already completed or failed are not cancellable (409).

curl -X POST https://thefatbaby.com/api/v1/jobs/JOB_ID/cancel \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "success": true,
  "job": { "id": "JOB_ID", "status": "cancelled", "progress": 0 }
}

Async extract audio track (mp3/aac/wav/flac/…)

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set format (e.g. mp3, aac, wav, flac).
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/audio/extract \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "format=mp3"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "audio.extract",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 3
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async loudness / level normalization

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Upload audio or video with an audio track; optional target loudness if supported.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/audio/normalize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@track.wav"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "audio.normalize",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 3
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async palette GIF from a short clip window

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Set start, duration, and optional width for the GIF window.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/gif/from-video \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "start=0" \
  -F "duration=3" \
  -F "width=480"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "gif.from-video",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 4
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async HLS packaging (alias of /v1/video/hls)

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Upload source video; wait for completed job then download the HLS package / playlist artifacts.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/stream/hls \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.hls",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 8
  },
  "request_id": "req_…",
  "credits_used": 0
}

Async hard-burn SRT/VTT into the video picture

1. Create an API key and confirm your credit balance covers the operation.
2. POST multipart/form-data (file and options) with Authorization: Bearer <key>.
3. Upload video as file and subtitle file (e.g. subtitles=@captions.srt). Alias also under /v1/subtitles/burn.
4. Read job.id from the JSON response (status is usually queued). Credits are reserved, not yet captured.
5. Poll GET /v1/jobs/:jobId until status is completed (or failed / cancelled).
6. Download via signed URLs in job.output.downloads, or GET /v1/jobs/:jobId/download?filename=…
7. On success, reserved credits are captured; cancel/fail releases per policy.

curl -X POST https://thefatbaby.com/api/v1/video/subtitles/burn \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "subtitles=@captions.srt"

{
  "success": true,
  "job": {
    "id": "…",
    "operation": "video.subtitles.burn",
    "status": "queued",
    "progress": 0,
    "credits_reserved": 5
  },
  "request_id": "req_…",
  "credits_used": 0
}

Validate and parse JSON payloads

1. Create an API key in the dashboard.
2. POST application/json with a json string field, or send a raw JSON object/array as the body.
3. Read valid and parsed. Invalid JSON still returns HTTP 200 with valid: false and consumes 1 credit.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/json/validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"name\":\"FatBaby\",\"ok\":true}"}'

{
  "valid": true,
  "parsed": {
    "name": "FatBaby",
    "ok": true
  },
  "request_id": "req_…",
  "credits_used": 1,
  "credits_remaining": 99
}

Read page count and document info (sync)

1. Create an API key and confirm credit balance.
2. POST multipart file=@document.pdf — sync JSON response.
3. Read credits headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/pdf/metadata \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "pages": 3,
  "request_id": "req_…",
  "credits_used": 1
}

Validate PDF structure (sync)

1. Create an API key and confirm credit balance.
2. POST multipart file=@document.pdf — sync JSON response.
3. Read credits headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/pdf/validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "pages": 3,
  "request_id": "req_…",
  "credits_used": 1
}

Merge multiple PDFs into one

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/merge \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.merge" },
  "credits_reserved": 1
}

Split PDF into per-page files (ZIP)

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/split \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.split" },
  "credits_reserved": 1
}

Keep selected pages (pages=1,3-5)

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/extract-pages \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.extract-pages" },
  "credits_reserved": 1
}

Delete selected pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/remove-pages \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.remove-pages" },
  "credits_reserved": 1
}

Reorder pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/reorder-pages \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.reorder-pages" },
  "credits_reserved": 1
}

Rotate pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/rotate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.rotate" },
  "credits_reserved": 1
}

Crop page boxes

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/crop \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.crop" },
  "credits_reserved": 1
}

Resize / fit pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/resize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.resize" },
  "credits_reserved": 2
}

Flatten interactive content

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/flatten \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.flatten" },
  "credits_reserved": 1
}

Repair damaged PDFs

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/repair \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.repair" },
  "credits_reserved": 1
}

Compress / optimize PDF size

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/compress \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.compress" },
  "credits_reserved": 2
}

Optimize PDF structure

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/optimize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.optimize" },
  "credits_reserved": 2
}

Password-protect a PDF

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/encrypt \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.encrypt" },
  "credits_reserved": 1
}

Unlock PDF with customer password

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/decrypt \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.decrypt" },
  "credits_reserved": 1
}

Add text watermark

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/watermark \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.watermark" },
  "credits_reserved": 1
}

Stamp text onto pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/stamp \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.stamp" },
  "credits_reserved": 1
}

Strip document metadata

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/remove-metadata \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.remove-metadata" },
  "credits_reserved": 1
}

HTML → PDF

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/from-html \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.from-html" },
  "credits_reserved": 2
}

URL → PDF (SSRF-protected)

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/from-url \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "url=https://example.com/invoice"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.from-url" },
  "credits_reserved": 2
}

Markdown → PDF

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/from-markdown \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.from-markdown" },
  "credits_reserved": 2
}

DOCX/XLSX/PPTX/ODT → PDF

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/from-office \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.from-office" },
  "credits_reserved": 3
}

Images → PDF

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/from-images \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.from-images" },
  "credits_reserved": 2
}

PDF pages → image ZIP

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/to-images \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.to-images" },
  "credits_reserved": 2
}

OCR scanned PDFs (eng/ara)

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/ocr \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.ocr" },
  "credits_reserved": 2
}

Add searchable text layer

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/make-searchable \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.make-searchable" },
  "credits_reserved": 2
}

Deskew scanned pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/deskew \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.deskew" },
  "credits_reserved": 2
}

Clean scanned pages

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/clean-scan \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.clean-scan" },
  "credits_reserved": 2
}

Produce PDF/A

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/to-pdfa \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.to-pdfa" },
  "credits_reserved": 2
}

Extract plain text

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/extract-text \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.extract-text" },
  "credits_reserved": 2
}

Extract tables as JSON

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/extract-tables \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.extract-tables" },
  "credits_reserved": 3
}

Extract embedded images metadata

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/extract-images \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.extract-images" },
  "credits_reserved": 2
}

PDF → Markdown

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/to-markdown \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.to-markdown" },
  "credits_reserved": 2
}

PDF → HTML

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/to-html \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.to-html" },
  "credits_reserved": 2
}

Structured document JSON

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/to-json \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.to-json" },
  "credits_reserved": 2
}

Generate PDF from JSON template

1. Create an API key and confirm credit balance.
2. POST multipart (and options) — response includes job.id (queued).
3. Poll GET /v1/jobs/:jobId until completed, then download.

curl -X POST https://thefatbaby.com/api/v1/pdf/generate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@document.pdf"

{
  "success": true,
  "job": { "id": "…", "status": "queued", "operation": "pdf.generate" },
  "credits_reserved": 2
}

Inspect workbook sheets, row counts, and size

1. Create an API key and confirm credit balance.
2. POST multipart file=@workbook.xlsx — sync JSON or binary response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/xlsx-info \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@workbook.xlsx"

{
  "sheets": [{ "name": "Sheet1", "rows": 12, "columns": 4 }],
  "sheet_count": 1,
  "size_bytes": 8420,
  "request_id": "req_…",
  "credits_used": 1
}

Convert a worksheet to CSV text

1. Create an API key and confirm credit balance.
2. POST multipart file=@workbook.xlsx — sync JSON or binary response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/xlsx-to-csv \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@workbook.xlsx" \
  -F "sheet=Sheet1"

{
  "csv": "name,qty\nAlpha,1\nBeta,2",
  "request_id": "req_…",
  "credits_used": 1
}

Convert CSV text or file to an XLSX workbook

1. Create an API key and confirm credit balance.
2. POST JSON body (or multipart for csv-to-xlsx file) — sync response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/csv-to-xlsx \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,qty\nAlpha,1"}'

HTTP 200
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="converted.xlsx"
X-Request-Id: req_…
X-FatBaby-Credits-Used: 1

<body = binary xlsx bytes>

Convert a worksheet to header + row objects

1. Create an API key and confirm credit balance.
2. POST multipart file=@workbook.xlsx — sync JSON or binary response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/xlsx-to-json \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@workbook.xlsx"

{
  "sheet": "Sheet1",
  "headers": ["name", "qty"],
  "rows": [{ "name": "Alpha", "qty": "1" }],
  "request_id": "req_…",
  "credits_used": 1
}

Build an XLSX workbook from row objects or multi-sheet input

1. Create an API key and confirm credit balance.
2. POST JSON body (or multipart for csv-to-xlsx file) — sync response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/json-to-xlsx \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"sku":"A1","price":"9.99"}]}'

HTTP 200
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="converted.xlsx"
X-Request-Id: req_…
X-FatBaby-Credits-Used: 1

<body = binary xlsx bytes>

Combine worksheets from multiple XLSX files into one workbook

1. Create an API key and confirm credit balance.
2. POST multipart files=@a.xlsx files=@b.xlsx — sync binary XLSX.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/merge-sheets \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "files=@a.xlsx" -F "files=@b.xlsx"

HTTP 200
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="merged.xlsx"
X-Request-Id: req_…
X-FatBaby-Credits-Used: 2

<body = binary xlsx bytes>

Split each worksheet into its own XLSX (base64 JSON map)

1. Create an API key and confirm credit balance.
2. POST multipart file=@workbook.xlsx — sync JSON or binary response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/split-sheets \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@workbook.xlsx"

{
  "sheets": [{
    "name": "Sheet1",
    "filename": "Sheet1.xlsx",
    "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "size_bytes": 5120,
    "base64": "UEsDB…"
  }],
  "sheet_count": 1,
  "request_id": "req_…",
  "credits_used": 2
}

Validate XLSX structure against size/sheet/row limits

1. Create an API key and confirm credit balance.
2. POST multipart file=@workbook.xlsx — sync JSON or binary response.
3. Read X-FatBaby-Credits-* headers / JSON credit fields.

curl -X POST https://thefatbaby.com/api/v1/sheets/validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@workbook.xlsx"

{
  "valid": true,
  "size_bytes": 8420,
  "sheet_count": 1,
  "sheets": [{ "name": "Sheet1", "rows": 12 }],
  "limits": { "max_upload_bytes": 10485760, "max_sheets": 50, "max_rows": 100000 },
  "request_id": "req_…",
  "credits_used": 1
}

Create job folders (input/output/temp). Alias: POST /v1/render/jobs

1. This is step 1 of the legacy pipeline (create → upload → render → poll → download).
2. POST /v1/render/job with Authorization: Bearer <key> (no body required). Alias: POST /v1/render/jobs.
3. Save job_id and the returned input/output/temp paths for later upload and render steps.
4. Next: upload with POST /v1/render/upload/:jobId. Costs 1 credit to create the job workspace.

curl -X POST https://thefatbaby.com/api/v1/render/job \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "success": true,
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "input_path": "/data/renders/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/input",
  "output_path": "/data/renders/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/output",
  "temp_path": "/data/renders/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/temp",
  "status": "created",
  "request_id": "req_…",
  "credits_used": 1,
  "credits_remaining": 99
}

Multipart field file into job input/. Alias: POST /v1/render/jobs/:jobId/files

1. Step 2 of the legacy pipeline — you already created a job and have job_id.
2. POST multipart file to /v1/render/upload/:jobId (field name file). Alias: /v1/render/jobs/:jobId/files.
3. Confirm the returned path under the job input/ folder. Repeat for extra inputs if needed.
4. Next: POST /v1/render/render. Costs 2 credits per upload.

curl -X POST https://thefatbaby.com/api/v1/render/upload/JOB_ID \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -F "file=@clip.mp4"

{
  "success": true,
  "job_id": "JOB_ID",
  "filename": "clip.mp4",
  "path": "/data/renders/jobs/JOB_ID/input/clip.mp4",
  "request_id": "req_…",
  "credits_used": 2,
  "credits_remaining": 97
}

Async ffmpeg via validated command; returns render_job_id

1. Build a validated ffmpeg command that only reads/writes under the job input/output/temp paths.
2. POST JSON { job_id, command } to /v1/render/render.
3. Save render_job_id and poll status until completed.
4. Costs 5 credits when the render starts.

curl -X POST https://thefatbaby.com/api/v1/render/render \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"JOB_ID","command":"ffmpeg -y -i /data/renders/jobs/JOB_ID/input/clip.mp4 /data/renders/jobs/JOB_ID/output/out.mp4"}'

{
  "success": true,
  "render_job_id": "r9f8e7d6-c5b4-3210-aaaa-bbbbccccdddd",
  "parent_job_id": "JOB_ID",
  "status": "processing",
  "output_path": null,
  "request_id": "req_…",
  "credits_used": 5,
  "credits_remaining": 92
}

Poll async render task. Also: /render/:id/status and /status/:id/logs

1. After starting a render, poll GET /v1/render/status/:renderJobId.
2. Wait until status is completed (or inspect error / stderr on failure).
3. Then download files from the parent job output/ folder.
4. Free (0 credits).

curl https://thefatbaby.com/api/v1/render/status/RENDER_JOB_ID \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "success": true,
  "render_job_id": "RENDER_JOB_ID",
  "parent_job_id": "JOB_ID",
  "status": "completed",
  "command": "ffmpeg -y -i …/input/clip.mp4 …/output/out.mp4",
  "output_path": null,
  "started_at": "2026-09-07T12:00:00.000Z",
  "completed_at": "2026-09-07T12:00:18.000Z",
  "error": null,
  "stdout": "",
  "stderr": "…ffmpeg progress…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 92
}

Download a file from job output/. Alias: /jobs/:jobId/download/:filename

1. When render status is completed, note the output filename under the parent job.
2. GET /v1/render/download/:jobId/:filename with Authorization.
3. Save the binary response. Free (0 credits).

curl https://thefatbaby.com/api/v1/render/download/JOB_ID/out.mp4 \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  --output out.mp4

HTTP 200
Content-Type: video/mp4
Content-Disposition: attachment; filename="out.mp4"
X-Request-Id: req_…
X-FatBaby-Credits-Used: 0
X-FatBaby-Credits-Remaining: 92

<body = binary file bytes>

Pretty-print or minify JSON

1. Create an API key in the dashboard.
2. POST /v1/tools/json-format-minify with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-format-minify \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"a\":1}","minify":false}'

{
  "result": "{\n  \"a\": 1\n}",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate JSON with structured errors

1. Create an API key in the dashboard.
2. POST /v1/tools/json-validate with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"ok\":true}"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Best-effort repair of common JSON issues

1. Create an API key in the dashboard.
2. POST /v1/tools/json-repair with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-repair \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{a:1,}"}'

{
  "repaired": "{\n  \"a\": 1\n}",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Compare two JSON documents with path + line diff

1. Create an API key in the dashboard.
2. POST /v1/tools/json-diff with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-diff \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"left":"{\"a\":1}","right":"{\"a\":2}"}'

{
  "equal": false,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate data against a JSON Schema

1. Create an API key in the dashboard.
2. POST /v1/tools/json-schema-validate with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-schema-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data":"{\"n\":1}","schema":"{\"type\":\"object\"}"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Query JSON with JSONPath

1. Create an API key in the dashboard.
2. POST /v1/tools/jsonpath with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/jsonpath \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"items\":[1]}","path":"$.items[*]"}'

{
  "result": [1],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert CSV to JSON or JSON to CSV

1. Create an API key in the dashboard.
2. POST /v1/tools/csv-json with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/csv-json \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"a,b\n1,2","direction":"csv_to_json"}'

{
  "headers": ["a","b"],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert JSON array of objects to CSV

1. Create an API key in the dashboard.
2. POST /v1/tools/json-csv with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-csv \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"[{\"a\":1}]"}'

{
  "csv": "a\n1",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert between JSON and XML

1. Create an API key in the dashboard.
2. POST /v1/tools/json-xml with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-xml \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"root\":{\"a\":1}}","direction":"json_to_xml"}'

{
  "xml": "<root>…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert between JSON and YAML

1. Create an API key in the dashboard.
2. POST /v1/tools/json-yaml with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/json-yaml \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"a\":1}","direction":"json_to_yaml"}'

{
  "yaml": "a: 1\n",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Remove empty rows; formula-injection safe cells

1. Create an API key in the dashboard.
2. POST /v1/tools/csv-clean with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/csv-clean \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"a\n1\n\n"}'

{
  "removed_empty_rows": 1,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate INSERT SQL (never executed)

1. Create an API key in the dashboard.
2. POST /v1/tools/csv-sql with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/csv-sql \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"id,name\n1,Ada","table":"people"}'

{
  "note": "Generated SQL is not executed…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate XML with XXE protections

1. Create an API key in the dashboard.
2. POST /v1/tools/xml-validate with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/xml-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"xml":"<root/>"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Encode/decode Base64 (not encryption)

1. Create an API key in the dashboard.
2. POST /v1/tools/base64 with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/base64 \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello","action":"encode"}'

{
  "note": "Base64 is encoding, not encryption…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Encode or decode URI components

1. Create an API key in the dashboard.
2. POST /v1/tools/url-encode with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/url-encode \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"a b","action":"encode"}'

{
  "result": "a%20b",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Encode or decode HTML entities

1. Create an API key in the dashboard.
2. POST /v1/tools/html-entities with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/html-entities \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"<b>","action":"encode"}'

{
  "result": "<b>",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Encode or decode hex

1. Create an API key in the dashboard.
2. POST /v1/tools/hex with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/hex \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hi","action":"encode"}'

{
  "result": "6869",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Compress/decompress gzip (base64)

1. Create an API key in the dashboard.
2. POST /v1/tools/gzip with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/gzip \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello","action":"compress"}'

{
  "result": "H4sI…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Compress/decompress brotli (base64)

1. Create an API key in the dashboard.
2. POST /v1/tools/brotli with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/brotli \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello","action":"compress"}'

{
  "result": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

SHA-256/384/512 (legacy MD5/SHA-1 labeled insecure)

1. Create an API key in the dashboard.
2. POST /v1/tools/hashing with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/hashing \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello","algorithm":"sha256"}'

{
  "hex": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

HMAC-SHA256/384/512

1. Create an API key in the dashboard.
2. POST /v1/tools/hmac with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/hmac \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"body","secret":"…","algorithm":"sha256"}'

{
  "hex": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Decode JWT without verifying authenticity

1. Create an API key in the dashboard.
2. POST /v1/tools/jwt-decode with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/jwt-decode \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"eyJ…"}'

{
  "note": "Decoding does NOT verify…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Verify JWT with secret, public key, or JWKS

1. Create an API key in the dashboard.
2. POST /v1/tools/jwt-verify with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/jwt-verify \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"eyJ…","secret":"…"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Score password strength (password not logged)

1. Create an API key in the dashboard.
2. POST /v1/tools/password-strength with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/password-strength \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"password":"…"}'

{
  "score": 3,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Checksum hash helper

1. Create an API key in the dashboard.
2. POST /v1/tools/checksum with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/checksum \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"file-bytes","algorithm":"sha256"}'

{
  "hex": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate UUID v4

1. Create an API key in the dashboard.
2. POST /v1/tools/uuid with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/uuid \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "uuid": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate ULID

1. Create an API key in the dashboard.
2. POST /v1/tools/ulid with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/ulid \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "ulid": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate NanoID

1. Create an API key in the dashboard.
2. POST /v1/tools/nanoid with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/nanoid \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"size":21}'

{
  "nanoid": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

CSPRNG token (hex/base64url)

1. Create an API key in the dashboard.
2. POST /v1/tools/random-token with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/random-token \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bytes":32}'

{
  "token": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

CSPRNG password generator

1. Create an API key in the dashboard.
2. POST /v1/tools/password-generator with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/password-generator \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":20,"symbols":true}'

{
  "password": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate QR PNG (URL/text/email/wifi/vCard…)

1. Create an API key in the dashboard.
2. POST /v1/tools/qr-codes with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/qr-codes \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format":"url","data":{"url":"https://example.com"}}'

PNG binary

Decode QR from image (file or image_base64)

1. Create an API key in the dashboard.
2. POST /v1/tools/qr-read with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/qr-read \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"…"}'

{
  "text": "…", "format": "qrcode",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate Code128/39/EAN/UPC/QR PNG

1. Create an API key in the dashboard.
2. POST /v1/tools/barcodes with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/barcodes \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"123456789012","format":"ean13"}'

PNG binary

Decode barcode from image (file or image_base64)

1. Create an API key in the dashboard.
2. POST /v1/tools/barcode-read with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/barcode-read \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"…"}'

{
  "text": "…", "format": "CODE_128",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate placeholder text

1. Create an API key in the dashboard.
2. POST /v1/tools/lorem with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/lorem \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paragraphs":2}'

{
  "text": "Lorem…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Synthetic test records (not real identities)

1. Create an API key in the dashboard.
2. POST /v1/tools/fake-data with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/fake-data \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'

{
  "note": "Synthetic test data only…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate a color palette

1. Create an API key in the dashboard.
2. POST /v1/tools/color-palette with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/color-palette \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":5}'

{
  "colors": ["#…"],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

camel/Pascal/snake/kebab/title/…

1. Create an API key in the dashboard.
2. POST /v1/tools/text-case with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/text-case \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello world","case":"camel"}'

{
  "result": "helloWorld",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

URL-safe slug

1. Create an API key in the dashboard.
2. POST /v1/tools/slug with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/slug \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Hello World!"}'

{
  "result": "hello-world",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Line or character diff

1. Create an API key in the dashboard.
2. POST /v1/tools/text-diff with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/text-diff \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a":"one","b":"two"}'

{
  "changes": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Characters, words, lines

1. Create an API key in the dashboard.
2. POST /v1/tools/text-count with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/text-count \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello world"}'

{
  "words": 2,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Deduplicate lines/tokens

1. Create an API key in the dashboard.
2. POST /v1/tools/remove-duplicates with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/remove-duplicates \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"a\na\nb"}'

{
  "removed": 1,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

String find/replace

1. Create an API key in the dashboard.
2. POST /v1/tools/find-replace with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/find-replace \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"aa","find":"a","replace":"b"}'

{
  "replacements": 2,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Regex match with ReDoS limits

1. Create an API key in the dashboard.
2. POST /v1/tools/regex-test with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/regex-test \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"abc","pattern":"[a-z]+"}'

{
  "matches": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert markdown; HTML sanitized

1. Create an API key in the dashboard.
2. POST /v1/tools/markdown-html with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/markdown-html \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hi"}'

{
  "sanitized": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Sanitize HTML (no script execution)

1. Create an API key in the dashboard.
2. POST /v1/tools/html-sanitize with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/html-sanitize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html":"<script>x</script><b>ok</b>"}'

{
  "html": "<b>ok</b>",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

JSON/CSS/JS whitespace minify (no JS exec)

1. Create an API key in the dashboard.
2. POST /v1/tools/code-minify with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/code-minify \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"{\"a\": 1}","language":"json"}'

{
  "result": "{\"a\":1}",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

NFC/NFD/NFKC/NFKD

1. Create an API key in the dashboard.
2. POST /v1/tools/unicode-normalize with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/unicode-normalize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"é","form":"NFC"}'

{
  "result": "é",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Levenshtein similarity ratio

1. Create an API key in the dashboard.
2. POST /v1/tools/string-similarity with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/string-similarity \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a":"kitten","b":"sitting"}'

{
  "ratio": 0.57,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert unix ↔ ISO

1. Create an API key in the dashboard.
2. POST /v1/tools/timestamp with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/timestamp \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":1710000000}'

{
  "iso": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

IANA timezone conversion (DST-aware)

1. Create an API key in the dashboard.
2. POST /v1/tools/timezone with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/timezone \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-01-01T12:00:00Z","from":"UTC","to":"America/New_York"}'

{
  "to_local": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Difference between two dates

1. Create an API key in the dashboard.
2. POST /v1/tools/date-difference with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/date-difference \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-01-01","end":"2026-01-02"}'

{
  "days": 1,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate cron + next runs

1. Create an API key in the dashboard.
2. POST /v1/tools/cron-parse with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/cron-parse \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expression":"0 * * * *","timezone":"UTC"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Next N cron executions

1. Create an API key in the dashboard.
2. POST /v1/tools/cron-next with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/cron-next \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expression":"0 0 * * *","count":5}'

{
  "next_runs": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert B/KB/MB/GB/TB

1. Create an API key in the dashboard.
2. POST /v1/tools/file-size with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/file-size \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":1,"from":"mb","to":"kb"}'

{
  "value": 1024,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Convert bases 2/8/10/16

1. Create an API key in the dashboard.
2. POST /v1/tools/number-base with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/number-base \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":"ff","from_base":16,"to_base":10}'

{
  "result": "255",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

part/whole or percent of

1. Create an API key in the dashboard.
2. POST /v1/tools/percentage with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/percentage \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part":25,"whole":100}'

{
  "percent": 25,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Fetch title/description (SSRF-safe)

1. Create an API key in the dashboard.
2. POST /v1/web/url-metadata with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/url-metadata \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "title": "Example Domain",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

OG / Twitter card metadata

1. Create an API key in the dashboard.
2. POST /v1/web/link-preview with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/link-preview \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "site_name":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Static HTML text/links/images

1. Create an API key in the dashboard.
2. POST /v1/web/scrape with Authorization: Bearer <key>.
3. Successful calls consume 3 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/scrape \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "text":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

URL screenshot via Gotenberg

1. Create an API key in the dashboard.
2. POST /v1/web/screenshot with Authorization: Bearer <key>.
3. Successful calls consume 5 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/screenshot \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

PNG binary

URL to PDF via Gotenberg

1. Create an API key in the dashboard.
2. POST /v1/web/to-pdf with Authorization: Bearer <key>.
3. Successful calls consume 5 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/to-pdf \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

PDF binary

Check URL status + latency

1. Create an API key in the dashboard.
2. POST /v1/web/status with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/status \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "status": 200,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Follow redirects with revalidation

1. Create an API key in the dashboard.
2. POST /v1/web/redirects with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/redirects \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "redirect_chain": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Check links on one page (strict limits)

1. Create an API key in the dashboard.
2. POST /v1/web/broken-links with Authorization: Bearer <key>.
3. Successful calls consume 8 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/broken-links \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "broken": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Read TLS certificate metadata

1. Create an API key in the dashboard.
2. POST /v1/web/ssl with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/ssl \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'

{
  "valid_to": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

A/AAAA/MX/TXT/CNAME

1. Create an API key in the dashboard.
2. POST /v1/web/dns with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/dns \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'

{
  "a": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

DNS-based domain records

1. Create an API key in the dashboard.
2. POST /v1/web/domain-info with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/domain-info \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'

{
  "records": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Lookup public IP geo

1. Create an API key in the dashboard.
2. POST /v1/tools/network/ip with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/network/ip \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'

{
  "country_code":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

RDAP registration lookup

1. Create an API key in the dashboard.
2. POST /v1/tools/network/domain with Authorization: Bearer <key>.
3. Successful calls consume 2 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/network/domain \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

{
  "nameservers":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

VPN/proxy/TOR heuristic risk

1. Create an API key in the dashboard.
2. POST /v1/tools/network/ip/risk with Authorization: Bearer <key>.
3. Successful calls consume 2 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/network/ip/risk \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'

{
  "risk":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Resolve favicon URL

1. Create an API key in the dashboard.
2. POST /v1/web/favicon with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/favicon \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "favicon_url": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Fetch robots.txt

1. Create an API key in the dashboard.
2. POST /v1/web/robots with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/robots \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "robots": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Parse sitemap URLs (capped)

1. Create an API key in the dashboard.
2. POST /v1/web/sitemap with Authorization: Bearer <key>.
3. Successful calls consume 2 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/sitemap \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "urls": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Heuristic stack detection

1. Create an API key in the dashboard.
2. POST /v1/web/technology-detect with Authorization: Bearer <key>.
3. Successful calls consume 3 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/technology-detect \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "technologies": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Lightweight fetch timing

1. Create an API key in the dashboard.
2. POST /v1/web/performance with Authorization: Bearer <key>.
3. Successful calls consume 5 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/web/performance \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "ttfb_estimate_ms": 120,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

libphonenumber format check

1. Create an API key in the dashboard.
2. POST /v1/tools/verify/phone with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/verify/phone \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","default_country":"US"}'

{
  "valid":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Create short redirect link

1. Create an API key in the dashboard.
2. POST /v1/tools/utility/short-url with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/utility/short-url \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "short_url":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Tesseract OCR on images

1. Create an API key in the dashboard.
2. POST /v1/tools/ocr with Authorization: Bearer <key>.
3. Successful calls consume 3 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/ocr \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '(multipart file)'

{
  "text":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Invoice/receipt field heuristics

1. Create an API key in the dashboard.
2. POST /v1/tools/document/extract with Authorization: Bearer <key>.
3. Successful calls consume 5 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/tools/document/extract \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Invoice #1\nTotal: $10","schema":"invoice"}'

{
  "fields":
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Syntax, MX, disposable, role (no SMTP probe)

1. Create an API key in the dashboard.
2. POST /v1/email/validate with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

{
  "note": "Does not prove the mailbox exists…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

MX + SPF-like TXT

1. Create an API key in the dashboard.
2. POST /v1/email/domain-check with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/domain-check \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

{
  "mx": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Disposable domain detection

1. Create an API key in the dashboard.
2. POST /v1/email/disposable-check with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/disposable-check \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"a@mailinator.com"}'

{
  "disposable": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Role-based local-part detection

1. Create an API key in the dashboard.
2. POST /v1/email/role-check with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/role-check \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com"}'

{
  "role_based": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Normalize email address

1. Create an API key in the dashboard.
2. POST /v1/email/normalize with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/normalize \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"User@Example.com"}'

{
  "normalized": "user@example.com",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Gravatar URL from email hash

1. Create an API key in the dashboard.
2. POST /v1/email/gravatar with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/gravatar \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

{
  "url": "https://www.gravatar.com/…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate up to 100 emails

1. Create an API key in the dashboard.
2. POST /v1/email/batch-validate with Authorization: Bearer <key>.
3. Successful calls consume 2 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/email/batch-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@example.com"]}'

{
  "count": 1,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Structural OpenAPI checks

1. Create an API key in the dashboard.
2. POST /v1/dev/openapi-validate with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/openapi-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spec":"{\"openapi\":\"3.0.3\",\"info\":{},\"paths\":{}}"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Best-effort OpenAPI 3 stamp

1. Create an API key in the dashboard.
2. POST /v1/dev/openapi-convert with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/openapi-convert \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spec":"{…}"}'

{
  "note": "Best-effort…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Infer TS interface from JSON

1. Create an API key in the dashboard.
2. POST /v1/dev/json-to-typescript with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/json-to-typescript \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"a\":1}","name":"Root"}'

{
  "code": "export interface Root…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate model stubs for many languages

1. Create an API key in the dashboard.
2. POST /v1/dev/json-to-model with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/json-to-model \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"a\":1}","language":"python"}'

{
  "code": "class Root…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

SSRF-safe HTTP tester

1. Create an API key in the dashboard.
2. POST /v1/dev/http-request with Authorization: Bearer <key>.
3. Successful calls consume 2 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/http-request \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","method":"GET"}'

{
  "status": 200,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Validate status + JSON body

1. Create an API key in the dashboard.
2. POST /v1/dev/response-validate with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/response-validate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"{}","status":200,"expect_status":200}'

{
  "json_ok": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Build a mock HTTP response object

1. Create an API key in the dashboard.
2. POST /v1/dev/mock-response with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/mock-response \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":200,"body":{"ok":true}}'

{
  "status": 200,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Format SQL (never executed)

1. Create an API key in the dashboard.
2. POST /v1/dev/sql-format with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/sql-format \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sql":"select * from t"}'

{
  "note": "Formatting only…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Format GraphQL (never executed)

1. Create an API key in the dashboard.
2. POST /v1/dev/graphql-format with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/graphql-format \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ hero { name } }"}'

{
  "result": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Generate a cURL command

1. Create an API key in the dashboard.
2. POST /v1/dev/curl-generate with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/curl-generate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","method":"GET"}'

{
  "curl": "curl …",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Best-effort cURL to JS/Python

1. Create an API key in the dashboard.
2. POST /v1/dev/curl-to-code with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/dev/curl-to-code \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"curl":"curl https://example.com","language":"javascript"}'

{
  "code": "const res = await fetch…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Create a unique capture inbox URL

1. Create an API key in the dashboard.
2. POST /v1/webhooks/endpoints with Authorization: Bearer <key>.
3. Successful calls consume 1 credit(s).
4. Use request_id and credit fields for logging.

curl -X POST https://thefatbaby.com/api/v1/webhooks/endpoints \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My inbox"}'

{
  "endpoint": { "inbox_url": "…" },
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

List your webhook inboxes

1. Create an API key in the dashboard.
2. POST /v1/webhooks/endpoints with Authorization: Bearer <key>.
3. This tool is free (0 credits) but still rate-limited.
4. Use request_id and credit fields for logging.

curl https://thefatbaby.com/api/v1/webhooks/endpoints \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "endpoints": [],
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

HMAC-SHA256 sign a payload

1. POST /v1/webhooks/sign with payload + secret. Secrets are not logged.

curl -X POST https://thefatbaby.com/api/v1/webhooks/sign \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payload":"{}","secret":"…"}'

{
  "signature": "…",
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Verify HMAC-SHA256 signature

1. POST /v1/webhooks/verify with payload, secret, signature.

curl -X POST https://thefatbaby.com/api/v1/webhooks/verify \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payload":"{}","secret":"…","signature":"…"}'

{
  "valid": true,
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 99
}

Chat completion via self-hosted Ollama (non-streaming). Optional model must be allowlisted. Billed by tokens: 1 credit / 1K tokens (prompt+completion) after a shared 50K free tokens/month pool with generate and help.chat.

1. Create an API key in the dashboard.
2. POST application/json with messages: [{ role, content }] to /v1/ollama/chat.
3. Optional: model (allowlisted only), temperature, max_tokens / num_predict. Do not set stream: true yet.
4. Read message.content plus usage (tokens, free_tokens_applied, credits_charged) and credits_used.

curl -X POST https://thefatbaby.com/api/v1/ollama/chat \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Say hello in one short sentence."}]}'

{
  "ok": true,
  "provider": "ollama",
  "model": "llama3.2:1b",
  "message": { "role": "assistant", "content": "Hello!" },
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" }],
  "done": true,
  "streaming": false,
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 4,
    "total_tokens": 16,
    "free_tokens_applied": 16,
    "billable_tokens": 0,
    "credits_charged": 0,
    "free_tokens_remaining": 49984,
    "pricing": "1 credit / 1K tokens (prompt+completion). 50K tokens free / month."
  },
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 100
}

Single-prompt text generation via self-hosted Ollama (non-streaming). Same token meter + shared 50K free/month pool as chat.

1. POST { "prompt": "…" } with your API key.
2. Optional system, model (allowlisted), temperature, max_tokens.
3. Response includes response string, usage block, and credit fields.

curl -X POST https://thefatbaby.com/api/v1/ollama/generate \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Write a one-line tagline for an API platform."}'

{
  "ok": true,
  "provider": "ollama",
  "model": "llama3.2:1b",
  "response": "…",
  "done": true,
  "streaming": false,
  "usage": {
    "total_tokens": 40,
    "free_tokens_applied": 40,
    "billable_tokens": 0,
    "credits_charged": 0,
    "free_tokens_remaining": 49960,
    "pricing": "1 credit / 1K tokens (prompt+completion). 50K tokens free / month."
  },
  "request_id": "req_…",
  "credits_used": 0,
  "credits_remaining": 100
}

List allowlisted models installed on the self-hosted Ollama container (free).

1. GET /v1/ollama/models with Authorization: Bearer <key>.
2. Use only names in allowed_models / models for chat and generate.

curl https://thefatbaby.com/api/v1/ollama/models \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "ok": true,
  "provider": "ollama",
  "default_model": "llama3.2:1b",
  "allowed_models": ["llama3.2:1b"],
  "models": [{ "name": "llama3.2:1b", "size": 1330000000 }],
  "credits_used": 0,
  "request_id": "req_…"
}

API-key probe for self-hosted Ollama readiness (also public GET /health/ollama).

1. GET /v1/ollama/health with your API key, or GET /health/ollama without a key for a basic probe.

curl https://thefatbaby.com/api/v1/ollama/health \
  -H "Authorization: Bearer fb_live_YOUR_KEY"

{
  "ok": true,
  "provider": "ollama",
  "model": "llama3.2:1b",
  "streaming": false,
  "credits_used": 0,
  "request_id": "req_…"
}

Thin wrapper over Ollama with a FatBaby help system prompt. Shares the Ollama 50K free tokens/month pool; then 1 credit / 1K tokens. Dashboard Help UI still deferred.

1. POST { "message": "How do credits work?" } with your API key.
2. For general LLM use prefer /v1/ollama/chat.

curl -X POST https://thefatbaby.com/api/v1/help/chat \
  -H "Authorization: Bearer fb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"How do FatBaby API credits work?"}'

{
  "ok": true,
  "provider": "ollama",
  "model": "llama3.2:1b",
  "reply": "…",
  "usage": {
    "credits_charged": 0,
    "free_tokens_remaining": 49900,
    "pricing": "1 credit / 1K tokens (prompt+completion). 50K tokens free / month."
  },
  "credits_used": 0,
  "request_id": "req_…"
}