Getting Started

Splixir Documentation

Splixir is a managed media transformation API on elastic compute. Submit structured JSON jobs, get back verified files, and pay only for verified deliveries.

Splixir Image MVPLive$1.00 Free Trial

Resize, crop, convert (WebP, AVIF, PNG, JPEG), strip metadata, and rotate. Video & Audio schemas are reserved and return 501 until launch.

Let your coding agent wire Splixir up

Paste this one-line prompt into Claude Code, Codex, Cursor, or Antigravity to install the CLI, configure MCP, or integrate the REST API using splixir.com/SKILL.md.

Add Splixir media processing to my app: splixir.com/SKILL.md

Four non-negotiable principles#

01 / Structured Jobs

Structured operations only

Every job is a typed JSON array of operations (resize, crop, convert, strip_metadata, rotate). Raw FFmpeg flags are never exposed.

02 / Zero Custody

Zero custody & zero bandwidth fees

Pass remote URLs or pre-signed S3/R2 destinations, or stage local files for 24 hours. Ingress and egress bandwidth are never billed.

03 / Verification Gate

Failed jobs bill $0.00

Every output is re-probed before delivery and accompanied by a VerificationReport. If verification fails or infra errors occur, the reservation is released and you pay $0.

04 / Capability Routing

Capability before cost

Jobs route to hardware that guarantees codec and pixel-format fidelity first (CPU elastic pools for Image; Ada/Blackwell+ for AV1 and 4:2:2 video).

60-second Quickstart#

1. Sign in at console.splixir.com and verify your email to receive $1.00 in free promo credit (good for up to 1,000 WebP/JPEG/PNG image transforms, valid for 30 days).

2. Create an API key (splx_...) and submit a synchronous Image job with wait: true:

quickstart.shbash
curl -X POST https://api.splixir.com/v1/jobs \
  -H "Authorization: Bearer $SPLIXIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "image",
    "input": { "url": "https://images.unsplash.com/photo-1506744038136-46273834b3fb?w=2400" },
    "operations": [
      { "type": "resize", "width": 1200, "fit": "inside", "withoutEnlargement": true },
      { "type": "convert", "format": "webp", "quality": 85 },
      { "type": "strip_metadata", "keepOrientation": true, "keepColorProfile": true }
    ],
    "wait": true
  }'

Synchronous vs. Async jobs

Setting wait: true holds the HTTP connection for up to 25 seconds and returns 200 OK with the finished job and VerificationReport. Omit wait (or set false) for instant 202 Accepted + webhook delivery.

Verified job response#

When state reaches delivered, the response includes the ephemeral 24-hour downloadUrl (unless you supplied your own output.destination), the full verificationReport, and the exact billed microdollars.

200 OK — Delivered Jobjson
{
  "id": "job_01JMX9K2A8V3Q7N4P5R6T8W9YZ",
  "kind": "image",
  "state": "delivered",
  "input": {
    "url": "https://images.unsplash.com/photo-1506744038136-46273834b3fb?w=2400"
  },
  "operations": [
    { "type": "resize", "width": 1200, "fit": "inside", "withoutEnlargement": true },
    { "type": "convert", "format": "webp", "quality": 85 },
    { "type": "strip_metadata", "keepOrientation": true, "keepColorProfile": true }
  ],
  "output": {
    "format": "webp",
    "downloadUrl": "https://api.splixir.com/v1/outputs/job_01JMX9K2A8V3Q7N4P5R6T8W9YZ.webp",
    "expiresAt": "2026-11-23T14:25:00.000Z"
  },
  "verificationReport": {
    "verified": true,
    "engine": "libvips-8.15",
    "inputProbe": {
      "width": 2400,
      "height": 1600,
      "format": "jpeg",
      "bytes": 684210,
      "hasExif": true,
      "colorSpace": "srgb"
    },
    "outputProbe": {
      "width": 1200,
      "height": 800,
      "format": "webp",
      "bytes": 94120,
      "exifStripped": true,
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    "checks": [
      { "name": "format_match", "passed": true },
      { "name": "dimensions_match", "passed": true },
      { "name": "exif_stripped", "passed": true }
    ],
    "timingsMs": {
      "probe": 18,
      "download": 92,
      "transform": 64,
      "verify": 14,
      "upload": 41,
      "total": 229
    }
  },
  "costMicros": 1000,
  "costUsd": 0.001,
  "billed": true,
  "createdAt": "2026-11-22T14:24:59.700Z",
  "updatedAt": "2026-11-22T14:25:00.000Z",
  "completedAt": "2026-11-22T14:25:00.000Z"
}

Next steps#