API

Turn artwork into a print-ready file and get back a signed URL to the clean result. /v1/prep → 300 DPI transparent DTF PNG, /v1/vectorize → vector SVG, /v1/recolor → colour swap / tint, and /v1/gangsheet → many logos on one 21" sheet. Standard operations cost 1 credit (gang sheets: 1 per logo). AI Redraw costs 2 credits Standard or 4 Pro — same price on vectorize, trace included.

Authentication & credits

Send your key as a bearer token. Generate keys in your account → API keys (shown once). Each successful standard operation costs 1 credit. AI Redraw is 2 credits Standard / 4 Pro. Buy credits on the same page.

Authorization: Bearer mdtf_live_...

POST /v1/prep

https://worker.majordtf.com/v1/prep

curl -X POST https://worker.majordtf.com/v1/prep \
  -H "Authorization: Bearer mdtf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/logo.png",
    "print_width_in": 11,
    "salvage": "on",
    "redraw_tier": "standard",
    "garment_colors": ["#1a1a1a"],
    "thickness_protection": false
  }'

Request body

Response

{
  "status": "ok",
  "file_url": "https://…supabase.co/…/clean.png?token=…",  // clean, full-res, 24h
  "width": 3300,
  "height": 4436,
  "print_in": { "w": 11.0, "h": 14.79 },
  "method": "ai",
  "quality": "clean",
  "halftoned": false,
  "thin_lines": false,
  "thin_pct": 0.0,
  "credits_charged": 1,
  "balance": 41
}

file_url is a clean, un-watermarked, 24-hour signed URL. thin_lines flags sub-1 pt strokes that risk poor DTF adhesion — re-run with thickness_protection.

Idempotency

Send an Idempotency-Key header to make retries free. A repeat of the same key within 24 hours returns the original result with credits_charged: 0 and idempotent_replay: true — the pipeline doesn't re-run and you aren't billed again. Use a fresh key per distinct job; reuse it when an agent retries the same one.

-H "Idempotency-Key: <your-unique-id>"

Halftone options

Send a halftone object to screen the artwork into dots. Pass one garment_colors value and the prep runs a single pass — Color-Range select that shirt colour, tonal-screen the design (keeping its colours), knock the shirt colour out, and trim. Omit a field to use the default below.

curl -X POST https://worker.majordtf.com/v1/prep \
  -H "Authorization: Bearer mdtf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/art.png",
    "print_width_in": 11,
    "garment_colors": ["#000000"],
    "halftone": {
      "lpi": 25, "angle": 22, "dot": "round",
      "gamma": 0.5, "key_tol": 0.10, "softness": 0.35,
      "enhance": true
    }
  }'

Defaults match the MajorDTFRaster screen (25 LPI · 22° · round · gamma 0.5). Dots grow by area (Photoshop Halftone-Screen behaviour), so gamma and the levels map predictably onto printed density.

POST /v1/vectorize

Trace artwork into a clean vector SVG — a deterministic Image-Trace replica. Returns a signed .svg URL. 1 credit — or 2 Standard / 4 Pro flat when you opt into an AI redraw first (trace included).

curl -X POST https://worker.majordtf.com/v1/vectorize \
  -H "Authorization: Bearer mdtf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/logo.png",
    "clean_first": true
  }'

Request body

Response

{
  "status": "ok",
  "file_url": "https://…supabase.co/…/trace.svg?token=…",  // 24h
  "bytes": 48213,
  "credits_charged": 1,
  "balance": 40
}

POST /v1/recolor

Swap colours (e.g. white → black) or tint the whole design to one colour. Works on a PNG or an SVG. Returns a signed URL in the same format as the source. 1 credit.

curl -X POST https://worker.majordtf.com/v1/recolor \
  -H "Authorization: Bearer mdtf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/logo.png",
    "swaps": [{ "from": "#ffffff", "to": "#000000", "tolerance": 0.16 }]
  }'

Request body

Response

{
  "status": "ok",
  "file_url": "https://…supabase.co/…/recolor.png?token=…",  // 24h
  "ext": "png",        // "svg" if the source was an SVG
  "bytes": 603627,
  "credits_charged": 1,
  "balance": 39
}

POST /v1/gangsheet

Prep several logos and lay them onto one print-ready 21" DTF gang sheet at 300 DPI — each logo at its own width × quantity, row-packed, sheet height grows to fit. Returns a signed PNG URL. 1 credit per logo — quantities are free, and nothing is charged if the sheet can't be built.

curl -X POST https://worker.majordtf.com/v1/gangsheet \
  -H "Authorization: Bearer mdtf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "image_url": "https://example.com/a.png", "width_in": 8,  "qty": 3 },
      { "image_url": "https://example.com/b.png", "width_in": 4,  "qty": 2, "bg_method": "key" }
    ],
    "gap_in": 0.25,
    "sheet_width_in": 21
  }'

Request body

Response

{
  "status": "ok",
  "file_url": "https://…supabase.co/…/gangsheet.png?token=…",  // clean, 24h
  "width": 6300,
  "height": 4875,
  "print_in": { "w": 21.0, "h": 16.25 },
  "logos": 2,
  "total_pieces": 5,
  "credits_charged": 2,   // 1 per logo; quantities are free
  "balance": 38
}

POST /v1/roster — coming soon

Number a whole team from one call: pass the roster and the lettering style, get back a file per player or a single gang sheet. In development — not callable yet. Today the same job runs in the browser at majordtf.com/roster, free.

Errors

Command line

A pip-installable CLI (pure stdlib) wraps the same endpoint:

pip install majordtf
export MAJORDTF_API_KEY=mdtf_live_...
majordtf logo.png --width 11 --garment "#1a1a1a" --out ready.png

Calling from an agent? See the MCP docs.