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.
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.
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:
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
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.
{
"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#
Splixir Image Operations →
Full schemas for resize, crop (region & aspect/gravity), convert, strip_metadata, rotate, and limits.
REST & OpenAPI Reference →
Every endpoint, auth header, status code, and live OpenAPI 3.1 viewer.
Splixir CLI →
Transform local files or URLs from your terminal with zero-boilerplate staging.
MCP Server →
Connect Claude Desktop, Claude Code, Cursor, Codex, or Antigravity via Remote HTTP or Local Stdio.